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NOTATION CONVENTIONS USED IN THIS MANUAL 

The formats shown in this manual contain notations that are not part of the assem- 
bly language itself but are of the formal language used to describe the Extended 
Assembler. The notation conventions used in this manual are: 



UPPER 

CASE 

LETTERS 

lower 

case 

letters 



f } 



CO 



A curved arrow represents a carriage return. 

Parts of the format in upper case letters are literal parts of 
the assembly language and must appear in context exactly as 
shown in the format. 

Parts of the format in lower case letters are variables indi - 
eating that the programmer must substitute an appropriate item 
within a class, such as a symbol, a digit, or an expression. 
Standard notation variables used in this manual are: 

usr -sym a programmer -defined symbol 

exp an expression 

n a number 

Broken square brackets enclose optional parts of a format. 
(Parts of a format not in square brackets are required. ) 

A delta represents a terminator or break character; it can be 
any number and combination of spaces, tabulations, and 
commas. 

Ellipsis indicates that the preceding field can be repeated. 

A parenthesized quantity preceded by C means contents of . 
For example, 

C(AC2) 

means the contents of the accumulator AC2 . 



As an example of notation conventions, the source line format for the .END 
pseudo-op is: 



.END f Ae3q)J ) 



The format shows that the programmer must include the characters .END in the 
source line and may optionally include an expression. If an expression is included 
in the line, it must be preceded by a terminator such as a space, tab, or comma 
or series of spaces, tabs and commas. A carriage return must terminate the 
entire line. 
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CHAPTER 1 
INTRODUCTION TO THE EXTENDED ASSEMBLER 



The Extended Assembler allows the user to write source programs using such 
familiar characters as letters and numbers. With.these characters, symbols can 
be created that are meaningful to the programmer, but not meaningful to the com.- 
puter. It is the responsibility of the assembler to process source programs to pro- 
duce object programs in machine language, meaningful to the computer. To do 
this, the assembler simply substitutes a numeric code for each symbolic instruction 
code and a numeric address for each symbolic address. Each line of symbolic 

itlHtrnr'tinn ic t-r-OTiolatoH infn rmo li-no o'f ■""•»>'r»-^''^ t-^r^-^—^t-i^-^ 1.— 4.l-~ -r— 1-1 

SPECIAL EXTENDED ASSEMBLER FACILITIES 



In addition to providing basic assembly functions, the Extended Assembler includes 
facilities for relocatable programs, interprogram communication, and conditional 
assembly. 

Relocatable Programs 

Relocation is the process of moving a program from one portion of core to another 
and adjusting the necessary address references so that the program, in its new 
location, can be executed. This means that the address at which a relocatable 
program is loaded (its loaded origin) need not be the address at which it is assem- 

hlpd ni"R asspmhlpH ^r^o•in^. A T(aln(->at-QKlo r>-i-/ir>-i-oTvi r><%-n Kq r^l.i^«<^ i« ,^^,, ^..j4-„ui» 

area of core. The Relocatable Loader computes the algebraic difference between 
the baded and assembled origins of a program and uses it to adjust all addresses 
that are dependent on the assembled origin so that the program can execute properly 
from its loaded origin. 

The Extended Assembler offers two pseudo-ops that specify that program code is 
to be relocatable. Normally, the Extended Assembler assembles each source 
statement at an absolute address until it encounters these pseudo-ops. Refer to 
"Location Counter Pseudo-ops" in Chapter 6 for more information on these pseudo- 
ops and relocatable programs. 

Interprogram Communication 

With the interprogram communication facilities of the Extended Assembler, data, 
addresses, and constants can be defined in one program and referenced in another. 
By using the interprogram communication pseudo-ops, explained In Chapter 6, 
programmers can write related subprograms without concern for the absolute 
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locations of data and addresses shared by these programs at run time. 
Conditional Assembly 

The conditional assembly facilities of the Extended Assembler provide the pro- 
grammer with the capability to include or not to include portions of source code 
in the assembly process. Depending on the evaluation of an absolute expression, 
the Extended Assembler will either assemble or bypass a section of source code. 
The pseudo-ops necessary for controlling the conditional assembly are explained 
in Chapter 6. 

INPUT AND OUTPUT 

The Extended Assembler accepts one or more source files written in assembly 
language as input. It makes two passes (or reads) through the source files to 
produce output which includes, minimally, a listing of source program errors 
and, optionally, a source program listing and relocatable binary file. Figure 1-1 
illustrates the input to and possible output from the Extended Assembler. Each 
type of I/O is explained separately below. 



SOURCE 
FILE(S) 



EXTENDED 
ASSEMBLER 




ERROR 
LISTING 



SOURCE 
PROGRAM 
LISTING 
(OPTIONAL) 



RELOCATABLE 
BINARY FILE 
(OPTIONAL) 



Figure 1-1. Extended Assembler Input and Output 



Source Files 



The source file input to the Extended Assembler consists of characters that are 
a subset of the ASCII character set, written as a series of lines. The assembler 
scans this input line by line and translates it to binary machine language code. 
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Error Listing 

On the first pass over the source input, the assembler outputs a small subset of 
errors on the teletype. U a program listing is output, the error listing is optional 
and during the second pass, all errors in the source program are included as part 
of the program listing. (If a program listing is not output, a separate error listing 
is produced automatically, ) The error listing output on the second pass is a list of 
only those lines containing errors. The format of these lines is the same as the 
format of the source program listino". 

Source Program Listing 

The optional program listing allows the programmer to compare source input to the 

<juk,xxluxCj. ^yULj^i.. \xi ocLiiipjuc: oOuXcc jJxugXciiii iioLiii^ IB auuvvli 111 riguxt; i-Z. ) 

Each line of the program listing contains the following information: 
Column(s) Contents 

1-3 Up to three error codes. Each error in input 

generates a single -letter error code. The first 
error generates a letter in column 3; the second, 
in column 2; and the third. In column 3. Additional 
errors cannot be flagged. The meaning of each 
error code is given in Appendix B. If no error is 
detected in the line, these columns contain a two- 
digit line number, followed by a space. 

^ " xjwv-ci.i,±un j^uuilLCi, JJ. XCXCVcUlli ULllCJ. Wise, Lllt^st: 

colunms are blank. 

9 Relocation flag pertaining to the location counter. 

It can be one of the following: 

Flag Meaning 

blank absolute 

page zero relocatable 
' normal relocatable 

10-15 Data, if relevant; otherwise, these columns are 

blank. 
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Column(s) 



Contents 



16 



17 on 



Relocation flag pertaining to the data field. It can 
be one of the following: 

Flag Meaning 

blank sibsolute 

page zero relocatable 
= page zero byte relocatable 

normal relocatable 

normal byte relocatable 
$ displacement field is externally 

defined 

Source line as input. 



As part of the program listing, the Extended Assembler produces a cross reference 
listing of the symbol table, which may include user symbols or both user symbols 
and semi- permanent symbols. A sample cross reference listing follows. 



0002 EXAMP 



AO 
Al 
A2 

BITS 
LOOP 
MAGIC 
OUT 
SPROU 
START 
SUBR 



000000 

177777 

177776 

000030 

000011' 

000032 

000023 

000033 

000000 

000033 



1/19 
1/22 
1/24 
1/09 
1/11 
1/OS 
1/14 
1/37 
1/06 
1/16 

C 



1/21 
1/39 
1/40 
1/13 
1/16 
1/35 
1/18 



1/2: 



1/2^ 



1/32 



1/20 



1/26 



1/38 



1/26 



1/37 
J 



symbol 



I page and line where referenced, e. g, 

type of symbol 
relocatability 
location where defined 



1/26 
page line 



Figure 1-3. Sample Cross Reference Listing 

The meaning of the relocatability values given in the cross reference listing is 
identical to those given for the program listing. 
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Relocatable Binayy File 

The optional relocatable binary file is an object file that can be loaded by the re- 
locatable loader and executed. It is a translation of the lines of source program 
into a special blocked binary code. Most lines of source input translate into a 
single 16-bit (one-word) binary number for storage in core by the loader. Associated 
with each number is an address, although it is not necessarily the computer address 
at which the number will be stored by the relocatable loader. 
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Iia0(92 FTASK 








01 








02 


1 INITIATE A TASK 


193 








04 








05 








06 








07 








0a 








09 








10 












.TITLE 


FTASK 


12 




.ENT 


FTASK 


Id 




.EXTN 


CTASK 


14 




.EXTN 


FRET 


IS 




• EXTD 


.CPYL 


16 




.NREL 




17 00000*000004 




4 




16 00001M02400 


FTASKJ 


SUB 


0,0 


19 00002>041614 




8TA 


0f IASM»3 


20 00003*»0600n 


\ 


JSR 


•,CPYL 


21 000041023613 




UOA 


0f#PRIr3 


22 00005*02&611 




LDA 


IrNAMEfS 


23 00006'125120 




MOVZL 


Irl 


24 00007*031614 




LDA 


2rIASM,3 


25 U0010I151015 




MOV# 


2,2, SNR 


26 00011*000404 




JMP 


FTASl 


27 00012*033614 




LOA 


2r*IASM,3 


26 00013*151014 




MOV* 


2,2,SZR 


29 00014*125241 




HOVOR 


IfliSKP 


30 00015*125220 


FTASll 


MOVZR 


Irl 


31 00016*006407 




JSR 


•.CTASK 


32 »00l7*i^H«402 




JMP 


ERR 


33 00020*17/777 




FRET 




34 00021*031601 


err: 


LOA 


2,F0SP|3 


35 00022*021612 




LOA 


0,ERTN|3 


36 00023*041210 




STA 


0»FRTN,2 


37 00024*000020* 




FRET 




38 00025*177777 


.CTASKI 


1 CTASK 




39 177611 


NAME ■ 


FT8TR 




40 177612 


ERTN ■ 


NAME^-l 




41 177613 


PRI w ERTN*l 




42 177614 


lASM • 


PRI*1 




43 








44 




.END 





Figure 1-2. Sample Source Program Listliig 
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CHAPTER 2 
SOURCE PROGRAMS 



Assembly language source programs are composed of a series of lines. A line is 
ail characters scanned by the assembler up to a carriage return or form feed. The 
assembler recognizes several types of lines; each source line must conform to a 
given structure, depending on its type. In addition, each line must contain only 
characters in the Extended Assembler character set. 

CHARACTER SET 

The Extended Assembler accepts the follov/ing characters in a source program: 

1. Alphabetics A through Z 

2. Numerals through 9 

3. Special Characters: 

. /:;< = >© 

4. Format control and line terminators: 
carriage return, form feed, space, tab 

Appendix A contains a table of the Extended Assembler character set and their 
octal equivalents. As shown in that table, the assembler also accepts lower-case 
alphabetics, but automatically translates them to their upper-case equivalent. 

Three characters are unconditionally ignored by the assembler: 

Character Octal Value 

null 000 

line feed 012 

rubout 177 

Any character not in the Extended Assembler character set is flagged with a B 
(bad character) on the assembly listing. 

Source program characters having an incorrect parity are replaced by the assembler 
with the ASCII character "\". This character is ignored by higher level processing; 
that is, L\A is processed as LA. 
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SOURCE LINES 

Members of the Extended Assembler character set are combined to form source 
lines. The majority of source lines affect the generation of a 16-bit value (with 
relocation properties) that is to occupy a memory location at execution time. Any 
line, of this type is said to produce a storage word. The storage word has a value, 
usually defined by an expression or instruction, and an address. At assembly time, 
the address assigned is the contents of the current location counter (LC). The 
generation of each 16-bit storage word causes the contents of the location counter 
to be incremented by one. Thus, in general, storage words are assigned to 
consecutive increasing LC values. 

Several types of source lines produce storage words. Others are used to define 
symbols, control the assembly process, and provide instructions to the assembler. 
Assembly source lines must be one of the following types: 

1. Data 

2. Instruction 

3. Pseudo-op 

4. Equivalence 

Data Lines 

A data line is one of the simplest in the assembly language. It consists of a single 
numeric expression. 

A data line generates either a 16-bit storage word (if the expression is a single 
precision integer) or a 32-bit storage word (if the expression is a double precision 
integer or a floating point number). In fact, data lines provide the only means for 
storage of double precision and floating point values. 

The special character @ (explained in the next chapter) can be used anywhere in a 
data line to generate a full word indirect address. After the expression is evaluated, 
the assembler places a 1 in bit (the indirect addressing bit) of the storage word. 
Thus, for example, all of the following data lines have the same value. 

16(2644 
1026440 
2644@ 
@1322*2 



2-2 



Instruction Lines 

An instruction line is an instruction mnemonic, or op code, and any required or 
optional argument fields. All Instruction lines generate a 16-bit storage word, 
which provides an instruction to the assembler, such as load an accumulator, add 
two accumulators, or increment an accumulator. 

Instructions are described in Chapter 5. 

Pseudo-op Lines 

A pseudo-op Une must begin with a permanent symbol (except the symbol . ) and 
may be followed by one or more required or optional arguments. Some pseudo- 
op lines (such as .NREL and . ZREL) are merely commands to the assembler and 
do not generate either a storage word or 16-bit value. Others (such as .RDX) 
generate a 16-bit value, but do not increment the location counter. 



o 



Pseudo-ops and pseudo-op line syntax are described in Chapter 6. 

Equivalence Lines 

One means of assigning a symbolic name to a numeric value is by equivalence. An 
equivalence line associates a value with a symbol; that symbol can then be used 
any time the value is required. An equivalence line has the form: 



usr-sym=exp 



where usr-sym is a user symbol (conforming to the rules for symbols given in 
Chapter 3) and exp is an expression or instruction. The symbol to the left (usr - 
sym ) must be previously undefined in pass 1, and the expression at the right must 
be evaluable in pass 1. Examples of equivalence lines follow. 

A = 342 
B = A/2 
INS = ADD# 0, 1, SKP 

An equivalence line assembles as a 16-bit value, but does not affect the current 
location counter. 
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Labels 

Any source program line can contain a label. A label allows the programmer to 
name a storage word symbolically. Using the label, a programmer can then ref- 
erence the storage word without regard for its numeric address. 

A label is simply a user symbol; it must appear at the beginning of a source line and 
must be followed by a colon (:). A label must conform to rules established for any 
symbol, as described in Chapter 3. Like other symbols, a label has a value: its 
value is that of the current location counter; that is, it is the address of the next 
storage word assembled. Since some source lines do not generate storage words, 
this definition is not necessarily associated with the statement that it appears in. 
The following source line is given the label LOOP: 

LOOP: ADD#jEf, 1, SKP ) 

A source line can consist solely of a label. For example: 

lab: ) 

Any source line can have one or more labels, provided all symbols are defined 
at the beginning of the line. For example: 

L00P:LAB1:LAB: ADE# j3,l, SKP ) 

Comments 

An assembly language program can include comments to facilitate program check- 
out, maintenance, and documentation. A comment is not interpreted in any way by 
the assembler and cannot affect the generation of the object program. All comments 
must be preceded by a semicolon (;). Upon encountering a semicolon, the assem- 
bler ignores all subsequent characters up to a carriage return. The following 
source program lines illustrate the use of comments. 

; THIS SUBROUTINE CALCULATES THE ABSOLUTE VALUE OF A NUMBER 
; IN AC0 

.TITL .ABSL 

.ENT .ABS 

.NREL 
.ABS: MOVL#0, 0, SZC ;TEST SIGN 

NEC 0, ;NEGATE IF NEGATIVE 

JMP0, 3 

.END ;END OF ABSOLUTE VALUE SUBR. 
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Source Line Formatting 

Within broad limits, the programmer is free to determine the form.at of the source 
lines for a program. For example, all of the following lines are identical in mean- 
ing to the assembler; they differ only in format. 

LAB: ADD# 2,3, SZR ;SKIP IF SUM = ZERO 

LAB:ADD,2,3,SZR#;SKIP IF SUM = ZERO 

LAB: ADD 2 3 SZR # ; SKIP IF SUM = ZERO 

(The special character # can appear anywhere in a source line. ) 

A common practice in writing source programs is to divide each line into fnnr 
columns by means of three tab settings, using the leftmost column for labels, the 
second column for the begiiming of the source line, the third for arguments, and 
the rightmost for comments. The first example above is in this format. If the 
listing device is not equipped with automatic tabbing (such as the ASR 33), the 
Extended Assembler simulates tabs by spacing to the nearest assembler-defined 
tab position (and always leaving at least one space between fields). Assembler- 
defined tab positions are at every eight columns; that is, at columns 9, 17, 25 etc. 
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CHAPTER 3 
ATOMS 



An atom, the basic unit of the assembly language, is a character or group of 
characters having special meaning to the assembler. All characters, except 
those in comments or text strings, are interpreted by the Extended Assembler 
as an atom or part of an atom. The general classes of atoms, 
1. terminators. 



1 TmTY-»l-\/-i-vc-< 



3. symbols, and 

4. special atoms 

are described on the following pages. 

TERMIinATORS 



Terminators separate numbers and symbols from other numbers and symbols. 
They can be used as either operators or breaks. 

Operators 

Operators are a set of terminators used with single precision integers and symbols 
to form expressions. The operators are: 



Arithmetic 



B bit alignment (shift) 
+ addition 

subtraction 
* multiplication 
/ division 



Logical ) & AND 

j ! inclusive OR 



Breaks 



Break characters are terminators that are used primarily as separators. These 
characters are: 

space 

, (comma) 

; (semicolon) 

(colon) 
= (equals sign) 
horizontal tab 
form feed 
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Space, comma and tab are interchangeable in source code; the assembler handles 
them identically. These characters are represented by a A in this manual. When- 
ever a A is shown, any number or combination of spaces, commas, and tabs can 
be used. 

Colon terminates a label. Equals sign terminates an equivalenced symbol. A semi- 
colon is used to indicate the beginning of a comment and may, optionally, terminate 
a line of source code. Carriage return and form feed terminate a Line of source 
code. 

NUMBERS 

The Extended Assembler recognizes three types of numbers: 

1» Single precision integer 

2. Double precision integer 

3. Single precision floating point 
Single Precision Integers 

A single precision integer is a string of one or more digits in the current radix. 
It can be preceded by a minus sign ( - ) if it is negative or an optional plus sign 
( + ) if it is positive. (An unsigned integer is considered positive. ) If the integer 
is decimal it may be followed by a decimal point. All integers must be terminated 
by an operator or break atom. Thus, the source code format for a single precision 
integer is: 



t±3dfd...d3 f.^ term 



where d is any digit within the current radix and term is a terminator (operator 
or break atom). If a decimal point precedes the terminator, the integer is evaluated 
as decimal. If there is no decimal point, the integer is evaluated in the current 
radix . (The normal radix, eight, can be changed by the . RDX pseudo-op. Refer 
to "Radix Pseudo-op" in Chapter 6. ) 

The Extended Assembler translates all single precision integers to a single word 
of 16 bits. The integer can be interpreted as signed using twos complement 
arithmetic in which bit is the sign bit. Bit is if the integer is positive; 1 
if it is negative. A single precision integer is represented in core as: 



1 15 



*-sign /O = + 
\l = - 
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The range of a single precision integer must be through 65535 (decimal) or 
through 177777 (octal). 

Double Precision Integers 

A double precision integer is one or more digits followed by the letter D. It can be 
preceded by a minus sign or optional plus sign. If the integer is decim.al, it m.ay 
be followed by a decimal point. All double precision integers must be terminated 
by a break atom. Thus, the source code for a double precision integer is: 



[±3 dE d...dH . iD break 



where d is any digit within the current radix and break is a break atom, typically 
a space, semicolon, or carriage return. (If a double precision integer is followed 
by an operator, a format error results. ) If a decimal point precedes the D, the 
integer is evaluated as decimal. If there is no decimal point, the integer is evaluated 
in the current radix. 

The Extended Assembler translates all double precision integers to two contiguous 
words, the first word of which is the high-order word (the first 16 bits of the 
integer). Bit of the high-order word contains the sign and bits 1 through 31 
contain the magnitude in twos complement notation. A double precision integer is 
represented in core as: 



1 


15 


1 high -order word 


low -order word 



' — sign 



{?:: 



Double precision integers cannot be combined in expressions; they can be used only 
in data lines. 

Some examples of assembled values of data lines containing double precision integers 
are: 



000001 


200000D 


000000 




000003 


262147. D 


000003 
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Floating Point Numbers 

A floating point number is one or more digits followed by (1) a decimal point 
and at least one more digit and/or (2) the letter E and at least one digit. 
It can be preceded by a minus sign or optional plus sign. All floating point 
numbers must be terminated by a break atom. Thus, the source code for a 
floating point number is: 



i±} d{ d. ..d} .df d. ..d} break 



or 



[±} d {d. . . d } . d {d. . . d} E { ± } d { d } break 



or 



f±}dfd...d}E{ + } dfd} break 



where d is any digit within the current radix and break is a break atom, typically 
a space", semieoldn, or carriage return. (If a floating point number is followed 
by an operator, a format error results. ) The number following the E is a decimal 
power of ten used to evaluate the number. For example, the number . 5 can be 
represented as: 
+0.5 



or 



or 



0.5 



5.0E-1 

The Extended Assembler translates all floating point numbers to two words, using 
the binary fraction representation described in Appendix C of How to Use the Nova 
Computers. If a number is specified that is too large or too small to be represented, 
it is regarded as an error and flagged with an N on the assembly listing. 

Floating point numbers cannot be combined in expressions; they can be used only 
in data lines. 
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Some examples of floating point numbers in data lines with their assembled values 
are: 



j34|342p l.p 

P 40426 3.1415926 
j3 41766 
140420 -1E0 
00000 

040200 +5.0E-1 
000000 



SYMBOLS 

A primary function of the Extended Assembler is the recognition and interpretation 
of symbols. Symbols are used both to direct the action of the assembler and to 
represent numeric values. A symbol can be written as a series of letters, numbers, 
or periods. Any other character in a symbol is interpreted as an error and is 
given a bad character (B) flag in the assembly listing. The following rules also 
apply to symbols. 

1. The first character in a symbol must be an alphabetic (A through Z) 
or a period (. ) 

2. A symbol must be unique within the first five characters. Although 
symbols can have any number of characters, the assembler uses only 
the first five to differentiate among them. All symbols whose first 
five characters are the same are indistinguishable to the assembler. 

3. A symbol must be terminated by an operator or break atom. 

Thus, the character strings 

A12 .SYB EXIT Z 
are all legitimate symbols while the strings 

1.27 IBC LA$3 

are not: the first two do not begin with a letter or . and the last contains an illegal 
character. Also, the character strings 

BITMASK BITMA. 7 BITMAl 

are treated as the same symbol (BITMA) by the assembler. 
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Symbols recognized by the Extended Assembler are classified as; 

1. Permanent 

2. Semi-permanent 

3. User 

An understanding of the differences among these classes is essential to the use of 
the assembly language. 

Permanent Symbols 

Permanent symbols are defined by the assembler and cannot be altered in any way. 
These symJDols are used to direct the assembly process and to represent numeric 
values of internal assembler variables. 

Symbols used to direct the assembly process are called pseudo-ops. Pseudo-ops 
are used for such purposes as specifying the radix for numeric conversions, set- 
ting the location counter, and assembling ASCII text. Pseudo-ops are described 
in Chapter 6. 

The permanent symbol period ( . ), when used alone, is a special symbol whose 
value is equal to the current contents of the location counter. Thus, the iiistruction 

LDA 3,. +6 
is equivalent to the instruction 

LDA 3,6,1 

Semi -Permanent Symbols 

Semi-permanent symbols form a very important class usually thought of as 
instruction mnemonics or op codes. With appropriate pseudo-ops, symbols can 
be defined as semi-permanent; their future use implies further syntax analysis. 
For example, a symbol can be defined as "requiring an accumulator". Use of 
this symbol causes the assembler to scan for an expression following the symbol. 
If not found, a format (F) error results. If found, the value of the expression 
determines the value of the accumulator field bit positions to give a 16-bit value. 
The assembler instruction set is described in Chapter 5. 

Semi-permanent symbols can be saved and used, without redefinition, for all 
subsequent assemblies. The Extended Assembler contains a number of semi- 
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Semi-Permanent Symbols (Continued) 

permanent symbols defined specifically to conform to the Nova family instruction 
set. The user can eliminate these sjmibols and define his own set or, more 
commonly, can add to the given set. In addition to instruction mnemonics, several 
semi-permanent symbols are provided by Data General that can be used as operands 
within expressions. These include the skip mnemonics (such as SKP, SZR, SNR, 
and SZC) used in arithmetic and logical instructions and device codes (such as TTI, 
TTO, PTR, and FTP) used in I/O instructions. 

User Symbols 

The user can definR anv Rvmhnl that r\r\pa not /^nnfMr*- mitVi i->o-ri-^in/>'^4- "t- ^o—^s 
permanent symbols. Symbolic definitions are used for many reasons: to name 
a location symbolically, to assign a numeric parameter to a symbol, to name 
external values, to define global values, etc. These user symbols are maintained 
for the duration of an assembly in a symbol table that is printed after the 
assembly source listing. 

User symbols can be further classified as local or global. Local symbols have a 
value known only for the duration of the single assembly in which they are defined. 
Global symbols have a value known at load time; these symbols are used for inter- 
program communication. During assembly, the user can specify whether or not 
local symbols are to be included with the binary output. 

SPECIAL ATOMS 

Three special one -character atoms are available to the Extended Assembler user 
for: 

1. Converting an ASCII character to its 7-bit octal equivalent ("). 

2. Performing indirect addressing (@), and 

3. Setting the no-load bit of an arithmetic or logical instruction (#). 
ASCII Character Conversion 

A single ASCII character (except null, line feed, and rubout) can be converted to 

its 7-bit octal equivalent if it is preceded by a double-quote (") character; thus 

an ASCII character can be represented as a single precision integer. For example: 

i^!?i"*35:? ti+ f ASCII " + " 

I>1 1^ 1^ 3 5 »m f A S C 1 1 " - " 
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ASCII Character Conversion ( Continued) 

The " atom can be used in expressions, for example: 



000141 «A*40 

000172 ."Z + 40 
00M112 »h*9. 



Note that " ) assembles as optal 15 and also terminates the line. 



Indirect Addressing 

Indirect addressing can be specified for a memory reference instruction or a 
data word if one or more "at" signs (@) are included anywhere in a source pro- 
gram line. If the Extended Assembler encounters an @, it evaluates the memory 
reference instruction or data word, then sets the indirect addressing bit (bit 5 
for a memory reference instruction, bit for a data word) to 1. For example: 



000004 JHP RLO 
002004 JMP #RUO 



Setting No-load bit 

The programmer can set the no-load bit (bit 12) of an arithmetic or logical 
instruction by including one or more "pound" signs (#) in the source program 
line. If the assembler encounters a #, it evaluates the arithmetic or logical 
instruction, then sets bit 12 to 1 , thus preventing the loading of the shifter 
output. 



101102 MOVL 0,0»SZC 
101112 MOVL #0,0, SZC 
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CHAPTER 4 
EXPRESSIONS 

An expression is 

1. A symbol or single precision integer or 

2. A series of symbols and/or single precision integers separated by 
operators. 

Thus, the format of an expression in source code is: 



f opn]} opr opn2 



where opn and opn are operands: a symbol, a single precision integer, or another 
expression evaluating to a single precision integer, opr is one of the following 
operators: 

Operator Meaning 

B bit alignment (See below. ) 

+ addition or plus 

subtraction or minus 

* multiplication 

/ division 

& logical AND. The result in a given bit position is 1 

if both opn i and opn are 1 in the corresponding bit 
position. 

! logical inclusive OR. The result in a given bit position 

is 1 if opn^ and/or opn is 1 in the corresponding bit 
position. 

Except for the unary operators + and - , an operand must precede every operator. 
Either unary operator can follow an operator or precede an expression. 

If an expression contains an illegal operand (such as an external symbol, instruction 
mnemonic, double precision number, or floating point number), the source line is 
given a Z error flag on the assembly listing. 



4-1 



EVALUATION OF EXPRESSIONS 

Like a symbol or single precision integer, an expression has a 16-bit value which 
the assembler computes by performing the indicated operations. This computation, 
or evaluation, generally proceeds from left to right, one operator at a time. However, 
bit alignment is always performed before any other operation in an expression. 

If two operators are contiguous, the assembler assumes a zero operand between them. 
Hence, the expression: 

A+-B 
is equivalent to 

A-M)-B 
or simply A-B; while the expression 

A*-B 
is equivalent to 

A*0-B 

or -B. (However, the expression -B*A correctly multiplies A by -B. ) 

During expression evaluation, no check is made for overflow. 

BIT ALIGNMENT OPERATOR 

The Extended Assembler bit alignment operator provides a facility for right justi- 
fication of a single precision integer on a bit boundary. The bit alignment operator 
is used in source code as follows: 



n B d 



where n is a numJaer in the current radix to be aligned and d is a decimal number 
specifying the rightmost bit at which n is to be aligned. The aligned number is 
given the value: 



4-2 



100000 IBO 
000002 1B14 
002400 12B8 



RADIX 8 



RELOCATION PROPERTIES OF EXPRESSIONS 

Associated with each operand of an expression is its relocation property. The 
relocation property of the operands in an expression, in turn, determines the 
relocation property of the expression. Expressions described thus far have had 
absolute operands and the result of their evaluation has been absolute. 

An operand can have one of several relocation properties: 

absolute 

page zero relocatable 

normal relocatable 

page zero byte relocatable 

normal byte relocatable 

An absolute operand is one whose address is fixed; its loaded address is the same 
as its assembled address. 

Page zero relocatable operands are relocatable, yet must reside in page zero; 
normal relocatable operands can be relocated anywhere in core except page 
zero. These relocatable operands are converted to absolute during the loading 
process by the addition of a relocation constant. ' The relocatable loader maintains 
two relocation constants, a zero relocation (C^) and a normal relocation (C^) 
constant, to "fix" the addresses of relocatable values. 

B3^e relocatable operands are page zero or normal relocatable storage words that 
act as byte pointers: bits 0-14 of the pointer contain an address and bit 15 specifies 
the byte to be operated on. (Refer to page 2-21 in H ow to Use the Nova Computers. ) 
A byte pointer of this kind can be formed simply by doubling an address, and can be 
retrieved and regenerated by a shifting operation. The loader adds either 2C or 

2C to each byte relocatable value to convert it to absolute. 

n ■^ 
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During loading, the relocatable loader can add one and only one of five possible 
constants to a word: 0, C^, C^^, IQ^, or 2Cj^. This has two implications when 
relocatable operands are combined in expressions: 

1, Although the Extended Assembler permits the combining of page zero 
and normal relocatable operands in expressions, the operands must be 
such that either the page zero or the normal relocatable operands 
"cancel out". For example, the expression 

Z^ + Nj - Z2 + N2 - N3 

(where Z. represent page zero relocatable operands; N^ represent normal 
relocatable operands) is legal, but 

Zj + Z2+Ni 

is not. 

2. Loader modification of an address by more than twice a relocation 
factor is illegal. 

The following list indicates legal combinations of absolute and relocatable operands 
in expressions. Any expression not in that list, or not reducing to a form in that 1 
list, is flagged as a relocation (R) error in the assembly listing. (In the following 
list, a is an absolute operand, r is a relocatable operand. ) 

Expression Relocation Property 

a + a absolute 

a - a absolute 

r. +a relocatable 

r - a relocatable 

r + r byte relocatable 

r - r absolute 

a * a absolute 

a / a absolute 
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Expression 
a & a 



a ! a 



Relocation Property 

absolute 

absolute 



2 * r byte relocatable 

In addition, the following expressions are unconditionaly illegal: 
r*r a&r 



a/r 
r&r 



rir 
a!r 



In the example following, A is defined as an absolute value and R as a relocatable 
value. 





000002 


A=2 
.NREL 


00000 


' 000020 ' 


.+20 


00001 


000000 


R: 




000002- 


S=R+1 


00002 


000001 


A/A 


00003 


000002" 


R+R 


00004 


177777- 


R-A 


00005 


000001 


S-R 


R00006 


000000* 


A!R 



RELOCATABLE + ABSOLUTE = RELOCATABLE 
ABSOLUTE / ABSOLUTE = ABSOLUTE 
RELOC + RELOC = BYTE RECOCATABLE 
RELOCATABLE - ABSOLUTE = RELOCATABLE 
RELOCATABLE - RELOCATABLE = ABSOLUTE 
ILLEGAL. RESULTS IN RELOCATION ERROR 
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CHAPTER 5 



INSTRUCTIONS 



^n instruction is the assembly of one or more fields, initiated by the occurrence 
of a semi-permanent symbol(called the "instruction mnemonic") to form a 16-bit 
value. Fields in an instruction can be separated by a space, comma, or tab and 
must conform in number and type to the field requirements for the type of semi- 
permanent symbol. 

The DGC family of computers recognizes seven basic types of instructions. Each 
type has a corresponding pseudo-op enabling definition of semi -permanent symbols 
within the type, (Refer to "Symbol Table Pseudo-ops" in Chapter 6 for additional 
information on these pseudo-ops. ) Instructions fall into the following seven types: 



1. Arithmetic and logical 

2. Memory reference without 
accumulator 



(Instruction mnemonic defined by . DALC) 
(Instruction mnemonic defined by . DMR) 



3. Memory reference with (Instruction mnemonic defined by . DMRA) 

accumulator 



t . input/ output witnout 
accumulator 



(Instruction mnemonic defined by . DIO) 



5. Input/output with accumu- (Instruction mnemonic defined by . DIOA) 
lator 



Input/output without de- 
vice code 



(Instruction mnemonic defined by . DIAC) 



7. Input/output without ar- 
gument fields 



(Instruction mnemonic defined by . DUSR) 



The instructions corresponding to these instruction types are described fully in 
How to Use the Nova Computers. The syntax required for each instruction type is 
given on the following pages. The semi-permanent symbols listed for each type 
are those defined by Data General. 
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ARITHMETIC AND LOGICAL (ALC) INSTRUCTIONS 

An arithmetic and logical (ALC) instruction is implied when the instruction 
mnemonic is one of the following: 



COM MOV 



NEC INC 



ADC ADD 



SUB 



AND 



The format of the source program instruction is: 



ale -mnemonic (carry^ ^shiftj Asource-ac Adestination-ac f^kii^ 



where: 

alc-mjiemonic 
carry 
shift 
source -ac 

destination-ac 

skip 



is one of the eight semi-permanent symbols listed above. 

is an optional Carry bit mnemonic. 

is an optional shift mnemonic. 

is a 0, 1, 2, or 3, indicating the accumulator to be 
used as the source accumulator. 

is a 0, 1, 2, or 3, indicating the accumulator to be 
used as the destination accumulator. 

is an optional skip mr-<^monlc. 



In addition, the atom # can be specified anywhere in the source line as a break 
character. If it is used, a 1 is assembled at bit 12, the no-load bit, thus 
inhibiting loading of shifter output. 

Figure 5-1 shows the assembled ALC instruction as well as the bit pattern and 
effect of the instruction, shift. Carry, and skip mnemonics. 

Examples of ALC instructions follow 



191112 

137000 



HOVU# 2f2f8ZC 
ADD 1,3 
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source 
ac 



destin 
ac 



1 2 

ALC Bits 

Mne. 5 6 7 Effect * 



ale 
mnemonic 

5 6 t" 



shift 



carry 



no 
load 



skip 



10 



11 



12 13 14 15 



COM 

NEC 



Places logical complement of C (source -ac) in destination-ac 
1 Places negative of C ( source -ac) in destination -ac 



MOV 10 Moves C ( source -ac) to destination-ac 

INC Oil Places C (source-ac>M in destination-ac 

ADC 10 Adds logical complement of C ( source -ac) to C (destination-ac) 

SUB 10 1 Subtracts C ( source -ac) from C ( destination-ac ) 

^^DD 110 Places sum of C (source-ac ) and C (destination-ac) in destination-ac 



L 

R 

S 



QUr. 

Mne. 



SKP 
SZC 

SNC 
SZR 
SNR 
SEZ 

SBN 



AND 1 1 1 Places logical AND of C ( source-ac) with C (destination-ac) in 
destination-ac 



Shift Bits 
Mne. 8 9 



Effect 



Carry 

Mne. 



Bits 

10 11 Effect 



1 

1 
1 1 



Shifts word left one bit Z 
Shifts word right one bit O 
Swaps bytes of word C 



1 

1 
1 1 



Sets Carry to zero 

Sets Carry to one 

Complements current state 
of Carry 



LJXK.tD 



13 14 15 



Effect 



1 
10 

1 1 



1 

1 
1 1 



Skips next sequential word (NSW) unconditionally 

Skips NSW on zero Carry 

Skips NSW on nonzero Carry 

Skips NSW on zero result 

Skips NSW on nonzero result 

Skips NSW on zero Carry or result 

Skips NSW on zero Carry and result 

*Refer to Chapter 2 of How to Use the Nova Computers for the effect of these 
instructions on the Carry bit. ~~ 



Figure 5-1. Assembly of ALC Instruction 
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MEMORY REFERENCE (MR) INSTRUCTIONS WITHOUT ACCUMULATOR 

A memory reference (MR) instruction without an accumulator field is implied 
when the instruction mnemonic is one of the following: 

JMP ISZ 

JSR DSZ 

The format of the source program instruction is : 



mr- 


-mnemonic 


A displacement 
or 


A mode 


mr- 


-mnemonic 


A address 





where: 

mr-mnemonic is one of the four semi-permanent symbols listed above. 



displacement 
mode 



is any legal expression evaluating to an 8-bit integer 
in the range of -2008 th^^ough +1778- 

is a I, 2, or 3, indicating an explicit mode for forming an 
effective address (E), as follows: 

mode Formation of Effective Address (E ) 

1 Addressing is based on the contents of location 

counter: 

E=C(LC) + displacement 
an(i therefore 

C(LC) -2008^ E<C(LC>fl 778 

2 Addressing is based on the contents of AC2: 

E = C(AC2) + displacement 
and, therefore 

C(AC2)-2008 < E < C(AC2)+1778 

3 Addressing is based on the contents of AC3: 

E = C(AC3) + displacement 
and, therefore 

C(AC3)-2008 < E < C(AC3)+1778 
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address is any legal expression evaluating to an 8-bit integer in one 

of the following ranges: 

1. through +3778 (for page zero addressing) : addressing 
is direct and E = address. 

2. C(LC)-2008 through C(LC>fl778 (for LC-relative addressing); 
addressing is based on the contents of the location counter 
and E=C(LC) +address . '"'"'" """"''"" 

In addition, the atom @ can be specified anywhere in the source line as a break 
character. If it is used, a 1 is assembled at bit 5, the indirect addressing bit. 

Thus, the effective flddr*"ss in th*i inoi-ni,^«-)^n io o .^^5„<.„^ *~ ^i i . 

-.. ..i ^„ „.„ i**.jv^v.v.i.iwii xo u. j^uxiiLcx lu diiutiici location, 

which may, in turn, contain an indirect address. 

If only address is specified, the assembler determines if this address is in page 
zero (0 through 3773) or within 1778 words of the location counter. If the address 
is in page zero, bits 6 and 7 of the instruction word are set to 00 and the dis- 
placement field is set as follows : 

1. If the address is absolute, the displacement field is set to address. 

2. If the address is page zero relocatable (that is, assembled with the . ZREL 
pseudo-op), the displacement field is set to address with page zero * 
relocation and the line is flagged with a - in column 16 of the source 
program listing. 

3. If the address is an external displacement (that is, assembled with the 
. EXTD pseudo-op), the displacement is set to the external's value and 
the line is flagged with a $ in column 16 of the source program listing. 
(The value of an external is given in the cross reference Usting following 
the program listing. ) 

If address is within 1773 words of the contents of the location counter, bits 6 and 7 
are set to 01 and addressing is based on the current contents of the location 
counter (as in addressing mode 1). The displacement field of the instruction word 
is set to: address - C(LC). 

If address or the evaluation of displacement to an address does not produce an 
effective address within the appropriate range, an addressing (A) error is 
reported. 
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Figure 5-2 shows the assembled MR instruction as well as the bit pattern and 
effect of the instruction mnemonics. Figure 5-3 illustrates how effective addresses 
are formed. 

Examples of MR instructions and their assembled address and value follow. 
/(^Pt«-^d \/.l-Ad56 SOMTi: I5Z ST4K 



/,|/i^4(S i/-'/i^7 i"^ 



JSP SOBTt 



»9\?hl TiiAV^iA'i^ stak: ?i 



?!(^i?i(?i2 iA9\\AiA9i 



JMP l^.a 







mr 
mnemonic 



mode 



displacement 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 



Effect 

Jumps to effective address (loads effective address into LC) 

Jumps to sv±)routine at effective address; loads C(LC>4-1 into 
ACS 

Increments contents of effective address; skips next sequen- 
tial word (NSW) if result is zero 

Decrements contents of effective address; skips NSW if 
result is zero 



MR 


Bits 


Mnemonic 


3 4 


JMP 


00 


JSR 


1 



ISZ 



DSZ 



1 



1 1 



Figure 5 -2. Assembly of MR Instruction without Accumulator 



5-6 



address— bits 8-15 
00 —bits 6+7 





NO 



NO 




YES 



I 



address -C(LC)H3its 8-15 
01 -bits 6+7 



displacement — bits 
mode —bits 6+7 



?-15 



Figure 5-3. Formation of Effective Address for MR Instruction 
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MEMORY REFERENCE (MR) INSTRUCTIONS WITH ACCUMULATOR 

A memory reference (MR) instruction with an accumulator field is implied when 
the instruction mnemonic is one of the following: 

LDA STA 

The format of the source program instruction is: 



mra-mnemonic A accumulator A displacement A mode 

or 
mra-mnemonic A accumulator A address 



where: 

mra-mnemonic is a semi-permanent symbol: LDA or STA. 

accumulator is a 0, 1, 2, or 3, indicating the accumulator to receive or 

supply the data. 

displacement, mode, and address are the same as for MR instructions without 
an accumulator field. 

In addition, the atom @ can be specified anywhere in the source line as a break 
character. If it is used, a 1 is assembled at bit 5, the indirect addressing bit. 

Figure 5-4 shows the assembled MR instruction as well as the bit pattern and 
effect of the instruction mnemonics. 

Examples of MR instructions follow. 



Ci)(!l01 4 •040434 STA 0, FBU 

00015'02443g LOA I, Fei0 



000 47 r000£^0{»| FBi0I 
00050 «fe)007lM(? FBli:^ 



■00014«026PI01 LDA J,l,2 

2!?i0l5t.035(?l0S LDA 3,3f2 

0P)016'031002 LOA 2,2,2 
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mra 
mnemonic 



ac 



12 3 

MRA Bits 

Mnemonic 1 2 



LDA 



STA 



1 



1 



mode 



displacement 



3 / 8 y 10 11 12 13 14 15 



Effect 






Stores contents of A(J in effective address 
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I/O INSTRUCTIONS WITHOUT ACCUMULATOR 

An input/output instruction without an accumulator field is implied when the 
instruction mnemonic is one of the following: 



NIO 



SKPBN 



SKPDN 



SKPBZ SKPDZ 

The format of the source program instruction is : 



io-mnemonic f busy /done 3 A device -code 



where: 

io-mnemonic 

busy/done 

device -code 



is one of the five semi-permanent symbols listed above. 

is an optional Busy/Done bit mnemonic (NIO instruction 
only). 

is any legal expression evaluating to an integer that 
specifies a device. (Refer to Appendix E of How to Use 
the Nova Computers for legal device codes. ) 

Figure 5-5 shows the assembled I/O instruction as well as the bit pattern and 
effect of the instruction and Busy/Done mnemonics. 
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Examples of I/O Instructions without an accumulator follow: 



eeei 12 
eee 1 12 

ee2i77 



NIGS FTr. 
I'JIOS CFU 
iJIOS 7 7 







1 2 

I/O 

Mnemonic 

NIO 
SKPBN 
SKPBZ 
SKPDN 

SKPDZ 







io- mnemonic 



device -code 



3 4 5 6 7 

Bits 
5 6 7 8 9 Effect 



10 



11 



12 



13 14 15 



No operation 

1110 Skips next sequential word (NSW) if Busy is 1 

1110 1 Skips NSW if Busy is zero 

11110 Skips NSW if Done is 1 

11111 Skips NSW if Done is zero 



The following one -character mnemonics can be appended to the NIO instruction 
only. 



Busy/Done 
Mnemonic 



Bits 
8 9 

1 



1 



1 1 



Effect 

Clears Done and sets Busy, starting device 
(U device=77 or CPU, sets Interrupt On flag) 

Clears Done and Busy, idling device 

(If device=77 or CPU, clears Interrupt On flag) 

Sets Done and Busy, pulsing I/O bus control line 
(If device=77 or CPU, has no effect) 



Figure 5-5, Assembly of I/O Instruction without Accumulator 
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I/O INSTRUCTIONS WITH ACCUMULATOR 

An input/output instruction with an accumulator field is implied when the instruc- 
tion mnemonic field is one of the following: 

DIA DIB Die 

DOA DOB DOC 

The format of the source program instruction is: 



ioa -mnemonic f busy /done 3 A accumulator A device -code 



where: 

ioa-nmemonic 
busy/done 
accumulator 

device -code 



is one of the six semi-permanent symbols listed above. 

is an optional Busy/Done bit mnemonic. 

is a 0, 1, 2, or 3, indicating the accumulator to receive 
or supply the data. 



is any legal expression evaluating to an integer that 
specifies a device. (Refer to Appendix E of How To 
Use the Nova Computers for legal device codes. ) 



Figure 5-6 shows the assembled I/O instruction as well as the bit pattern and 
effect of the instruction and Busy/Done mnemonics. 

Examples of I/O Instructions with an accumulator field follow. 



074177 
0715U 
063077 


DIA 3* CPU 
DIAS 2,PTR 
DOC 0*7 7 
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1 1 



ac 



loa 
mnemonic 



DIA 


I 


DOA 


1 


DIB 


1 1 


DOB 


1 


Die 


1 1 


DOC 


1 1 



Busy/Done Bits 
Mnemonic 8 9 

S 1 



1 



1 1 



busy/ 
done 



device -code 



10 11 12 13 14 15 



lOA Bits 

Mnemonic 5 6 7 Effect 



Inputs data in A buffer of device to AC 
Outputs data in AC to A buffer of device 
Inputs data in B buffer of device to AC 
Outputs data in AC to B buffer of device 
Inputs data in C buffer of device to AC 
Outputs data in AC to C buffer of device 



Effect 

Clears Done and sets Busy, starting device 
(If device=77 or CPU, sets Interrupt On flag) 

Clears Done and Busy, idling device 

(If device=77 or CPU, clears Interrupt On flag) 

Sets Done and Busy, pulsing I/O bus control line 
(If device=77 or CPU, has no effect) 



Figure 5-6. Assembly of I/O Instruction with Accumulator 
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I/O INSTRUCTIONS WITHOUT DEVICE CODE 

Certain commonly used I/O instructions have been defined with a device code of 
CPU. These instructions require an accumulator field, but no device code field. 
An I/O instruction without a device code field is implied when the instruction 
mnemonic is one of the following: 

READS INTA MSKO 

The format of the source program instruction is: 



iac -mnemonic A accumulator 



where : 

iac-mnemonic 

accumulator 



is one of the three semi -permanent S3niibols listed above. 

is a 0, 1, 2, or 3, indicating the accumulator to receive 
or supply the data. 



These instructions are. equivalent to the following I/O instructions. 



I/O Instruction 
Without Device 
Code 

READS accumulator 

INTA accumulator 

MSKO accumulator 



Equivalent 
Instruction 

DIA accumulator, CPU 

DIB accumulator, CPU 

DOB accumulator, CPU 



Figure 5-7 shows the assembled I/O instruction as weU as the bit pattern and 
effect of the instruction mnemonics. 

Examples of I /O instructions without a device code follow. 



074 177 
06U77 



READS 3 
INTA 
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■ 1 


1 


1 


ac 


iac 
mnemonic 





111111 


1 


2 


3 4 


5 6 7 8 9 10 11 12 13 14 15 


lAC 

Mnemonic 


Bits 
5 6 7 

00 1 


Effect 

Reads contents of console data switches into AC . 


READS 




INTA 




1 1 


Places device code of first device on bus in bits 10 
through 15 of AC, acknowledging interrupt 


MSKO 




1 00 


Sets up Interrupt Disable flags in devices according 
to mask in AC 



Figure 5 -7. Assembly of I/O Instruction without Device Code 



I/O INSTRUCTIONS WITHOUT ARGUMENT FIELDS 

Four commonly used I/O instructions have been defined as semi-permanent symbols 
that do not require any argument field: 



lORST 



INTDS 



INTEN 



HALT 



The equivalent I/O instruction, assembled octal value, and effect of these 
instructions are given below. 



I/O Instruction 

Without Argument . 


Equivalent 
Instruction 


Octal 
Value 


Effect 


lORST 


Dice jZ(, CPU 


062677 


Clears all I/O devices and 
Interrupt On flag; resets clock 
to line frequency 


INTEN 


NIOS CPU 


060177 


Sets Interrupt On flag, enabling 
interrupts 


INTDS 


NIOC CPU 


060277 


Clears Interrupt On flag, dis- 
abling interrupts 


HALT 


DOC 0, CPU 


063077 
5-14 


Halts the processor 



I/O INSTRUCTIONS WITHOUT ARGUMENT FIELDS (contd. ) 
Examples of these instructions follow. 



062677 lORST 

1263077 HALT 

060177 INTEN 
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CHAPTER 6 
PSEUDO-OPS 

Pseudo-ops are permanent symbols that direct the assembly process. Extended 
Assembler pseudo-ops are grouped into the following eight categories, according 
to the functions they perform: 

1. Title pseudo-op 

2. Radix pseudo-op 

3. Symbol table pseudo-ops 

4. Location counter pseudo-ops 

5. Interprogram communication pseudo-ops 

6. Text pseudo-ops 

7. Conditional assembly pseudo-ops 

8. File terminating pseudo-ops 

Each category and pseudo-op is explained in this chapter in the above order. Appen- 
dix C gives a summary of all pseudo-ops, including their function, syntax, and use. 

In general, pseudo-op lines can appear anjwhere within a source program; however, 
the title and entry pseudo-ops must be declared before any statement generating 
object data. 

TITLE PSEUDO-OP 

The debugger, relocatable loader, and library file editor all use titles to identify 
relocatable binary output. For this reason, the Extended Assemlber includes the 
. TITL pseudo-op, which allows the user to specify a title for a program. The 
syntax for the .TITL pseudo-op is: 



TITL Ausr-sym 

— 
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TITLE PSEUDO-OP (Contd. ) 

The symbol specified with the pseudo-op becomes the program title and is printed 
at the top of every listing page. The symbol need not be unique from other symbols 
defined by the program. 

The .TITL source line must appear before any statement generating object data 
in a source program. If this pseudo-op is omitted, the program assumes the 
default title of . MAIN. If more than one . TITL pseudo-op is specified in a 
program, the last one before a line generating data is used as the program title. 

The following pseudo-op line names the program SQRT. 



.TITL SQRT 



RADIX PSEUDO-OP 

At the beginning of each assembly pass, the Extended Assembler interprets integers 
not containing a decimal point as octal. The user can change the radix of a number 
by including the . RDX pseudo-op in the source program. The format of the pseudo- 
op is: 



. RDX A exp 



where ex£is evaluated in decimal . Its range must be between 2 and 10 (decimal); 
that is, the range of exp must be: 

2<exp<10 

When the assembler encounters a . RDX pseudo-op, it converts every integer 
thereafter to the specified radix. Note that regardless of the radix used, any 
number containing a decimal point is interpreted as decimal. This feature allows 
the programmer to combine decimal numbers in expressions with numbers of 
other radices. 

Examples of the use of the .RDX pseudo-op follow. 
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.RDX2 


000005 


101 


000152 


101+101. 




.RDX8 


000101 


101 


000246 


101+101. 




. RDX 10 


000145 


101 


000312 


101+101. 



SYMBOL TABLE PSEUDO-OPS 

The symbol table, maintained by the Extended Assembler, is a list of all semi- 
permanent symbols defined by Data General (such as the instruction mnemonics) 
and permanent symbols (such as pseudo-ops). In addition, the symbol table can 
contain semi-permanent symbols defined by the user. The Extended Assembler 
includes eight pseudo-ops that allow users to add or delete semi-permanent symbols 
in the symbol table. 

The symbol table pseudo-ops define a user symbol as a semi-permanent one and 
assign a value to it. The pseudo-ops have the general form: 



pseudo-op A symbol = expression 



where pseudo-op is one of the following: 

.DALC .DMRA .DIOA .DUSK 

. DMR . DIO . DIAC 

(An eighth pseudo-op, .XPNG, has a unique form and is described later. ) The 
pseudo-op defines symbol as a semi -permanent symbol; its value is the value of 
expression . 

Each symbol table pseudo-op, except .DUSR, implies a certain type of instruction. 
Thus, once defined, the semi -permanent symbol must be used with expressions 
appropriate to the format required. For example, the pseudo-op .DALC defines 
a symbol that is an implied arithmetic and logical instruction mnemonic and 
which requires expressions following the symbol that are entered into those bit 
fields that would represent in an ALC the source and destination accumulations 
and the optional skip field. The symbol table pseudo -ops can b e used to define 
semi -permanent symbols of the following instruction types. 
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SYMBOL TABLE PSEUDO-OPS (contd. ) 



Pseudo-op 

.DALC 

.DMR 

.DMRA 

.DIO 

.DIOA 

.DIAC 



Instruction Type 

Arithmetic and logical 

Memory reference without accumulator 

Memory reference with accumulator 

I/O without accumulator 

I/O with accumulator 

I/O without device code 



For example, the pseudo-op .DALC defines a symbol that is an implied arithmetic 
and logical instruction mnemonic. When this symbol is used in a source program, 
the fields following the symbol are entered into the bit positions that represent 
source and destination accumulators and an optional skip mnemonic. The format 
for .DALC sjrmbol definition and the source line with the symbol as it would later 
be used follow. 



. DALC A symbol = expression 



S3nTibol A source -ac A destination -ac [ A skip ^ 



The fields are assembled as shown below. 





source 
ac 


destin. 
ac 




skip 



12 3 4 13 14 15 

The following is an example of . DALC symbol definition. 



103120 .DALC MULT4=103120 



127 120 MULT/i U 1 
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SYMBOL TABLE PSEUDO-OPS (contd. ) 

If an expression is to be added to a field that cannot accommodate it, an overflow 
(O) error is reported and the field remains unaltered. The following example 
illustrates a field overflow. 



103120 .DALC MULT4=103120 
300000 107 120 MULT4 4^1 



If an expression is to be added to a nonzero field, the expression must evaluate to 
zero; otherwise, an overflow (O) error occurs. For example: 



123120 .DALC MULT4=123120 j BITS 1-2 NOT ZEROED 
O00«0I 127 120 MULT4 1> 1 '; OVERFLOW ON EXP 1 

30002 123120 MULT4 0,0 ; ACCEPTABLE SINCE EXP I =( 



If an expression following a semi-permanent symbol does not fit the implied 
format, a format (F) error results. For example: 



103120 .DALC MULT4=103120 ;TWO, OPTIONALLY THREE, 

; EXPRESSIONS REQUIRED FOR 
F 123120 MULT4 1 iMULT4. 

00001 127121 MULT4, 1,1,1 
JF00002 127121 MULT4 1,1,1,1 

In summary, the expressions following a semi-permanent symbol must meet the 
following criteria. 

1. As many expressions must follow the semi-permanent symbol as are 
required by the implied format. Some formats permit optional as well 
as required fields. 

2. The expression must be able to fit the field in the semi-permanent 
symbol; otherwise, if 

expression . > (2 fi^ld-width _ ^^ 
the field is unaltered and an overflow (O) error Is reported. 
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SYMBOL TABLE PSEUDO-OPS (contd. ) 

3. If the expression is to be stored in a nonzero field, the expression must 
evaluate to zero; otherwise, the field is unaltered and an overflow (O) 
error results. 

4. The expression must meet the requirements of the implied format; 
otherwise, a format (F) error results. 

Although a user symbol defined in one pseudo-op can be redefined in another symbol 
table pseudo-op, only the last definition is assigned to the user symbol. 
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.DALC Pseudo-op 
The .DALC pseudo-op 



. DALC A symbol = expression 



defines symbol as a semi-permanent symbol with the value of expression. In 
addition, the use of this symbol implies the formatting of an arithmetic and logical 
instruction. At least two fields, and optionally three, are required with the symbol. 
The format in which the semi -permanent symbol is later used in a source program 
is: 



symbol A source-ac A destination -ac f A skip jj 



The fields are assembled as shown below. 



source 
ac 



destin. 
ac 



1 



skip 



13 14 



15 



The atom # can be specified anywhere in the source line as a break character. If 
it is used, a 1 is assembled at bit 12, the no-load bit, thus inhibiting loading of 
shifter output. 



The shift and Caxxy bits can be set by appending the following letters to a three- 
character symbol during . DALC definition: 



.DALC A symbol 



Z 
Of 



R-j = expression 
S 



These letters cause the shift and Carry bits to be set as described in Chapter 5 
for ALC instructions. 

An example of the . DALC pseudo-op follows. 



103400 .DALC ADD= 103400 

00000 103400 ADD 0^0 

00001 103402 ADD 0^0, S?C 
0000? 133401 ADD 1^2, SKP 
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. DMR Pseudo-op 
The . DMR pseudo-op 



. DMR A symbol = expression 



defines symbol as a semi-permanent symbol with the value of expression. In 
addition, the use of this symbol implies the formatting of a memory reference (MR) 
instruction without an accumulator field. The format in which the semi-permanent 
symbol is later used in the source program is: 



symbol A displacement A mode 



The fields are assembled as shown below. 








6 7 8 9 10 11 12 13 14 15 



The atom @ can be specified anywhere in the source line as a break character. If 
it is used, a 1 is assembled at bit 5, the indirect addressing bit. 

An example of the . DMR pseudo-op is given below. 



000000 .DMR JMP= 000000 
00205 001400 JMP 0,3 
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. DMRA Pseudo-op 
The .DMRA pseudo-op 



. DMRA A symbol = expression 



defines symbol as a semi-permanent symbol with the value of expression. In 
addition, the use of this symbol implies the formatting of a memory reference 
instruction requiring an accumulator field. The format in which the semi-perman- 
ent symbol is later used in the source program is: 



symbol A accumulator A displacement f A mode j 



The fields are assembled as shown below. 



ac 



mode 



displacement 







6 



10 11 12 13 



14 



15 



The atom @ can be specified anywhere in the source line as a break character. 
If it is used, a 1 is assembled at bit 5, the indirect addressing bit. 

An example of the . DMRA pseudo-op is given below. 



020000 . DMRA LDA = 20000 



00011 023400 LDA 0,@0,3 
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. DIP Pseudo-op 
The . DIO pseudo-op 



. DIO A symbol = expression 



defines symbol as a semi-permanent symbol with the value of expression . In 
addition, the use of this symbol implies the formatting of an I/O instruction with- 
out an accumulator field. Only one field is required with the instruction. The 
format in which the semi-permanent symbol is later used in the source program is: 



symbol A device -code 



The field is assembled as shown below. 




The Busy/Done bits can be set by appending one of the following letters to a three- 
character symbol during . DIO definition. 



. DIO A symbol 



C' = expression 
P 



These letters cause the Busy/Done bits to be set as described in Chapter 5 for I/O 
instructions without an accumulator field. 

An example of the .DIO pseudo-op is shown below. 



063400 .DIO SKPDN = 063400 



■00017 063413 SKPDN PTP 
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. DIQA Pseudo-op 
The .DIOA pseudo-op 



. DIOA A symbol = expression 



defines symbol as a semi-permanent symbol with the value of expression. In 
addition, the use of this symbol implies the formatting of an I/O instruction 
requiring two fields. The format in which the semi -permanent symbol is later 
used in a source program is: 



symbol A accumulator Adevice -code 



The fields are assembled as shown below. 



ac 



device -code 



U ^4 10 11 12 13 14 15 

The BusyA)one bits can be set by appending one of the following letters to a three - 
character symbol during . DIOA definition. 



, DIOA A symbol 



C = expression 
P 



These letters cause the BusyA^one bits to be set as described in Chapter 5 for I/O 
instructions with an accumulator field. 

An example of the .DIOA pseudo-op is shown below. 



060500 . DIOA DIA = 060500 
00110 060545 DIA 0,45 
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. DIAC Pseudo-op 
The . DIAC pseudo-op 



, DIAC A symbol = expression 



defines symbol as a semi-permanent symbol with the value of expression. In 
addition, the use of this symbol implies the formatting of an I/O instruction 
without a device code field. The format in which the semi-permanent symbol is 
later used in the source program is : 



symbol A accumulator 



The field is assembled as shown below. 




3 4 

The following is an example of the .DIAC pseudo-op. 



000430 . DIAC RPT = 000430 



00150 010430 RPT 2 
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. DUSR Pseudo-op 
The . DUSR pseudo-op 



, DUSR i symbol = expression 



defines symbol as a semi-permanent symbol with the value of expression . UnUke 
other semi-permanent symbols, a symbol defined by a . DUSR pseudo-op is 
merely given a value and has no implied formatting. The semi-permanent symbol 
can be used in the source program anywhere a single precision operand can be 
used. The following illustrates the . DUSR pseudo -op. 



000025 



DUSR B = 25 



000250 .DUSR = 8*10 



000223 C - B 



.XPNG Pseudo -op 

All symbol definitions except permanent syhibols can be deleted from the assembler 
symbol table by the pseudo -op: 



.XPNG 



After expunging the symbol definitions from the table, the programmer can define 
instruction mnemonics, such as ADD and JMP, in any way desired. 



XPNG 



020000 . DMRA LDA = 20000 
040000 . DMRA STA = 40000 



END 
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LOCATION COUNTER PSEUDO-OPS 

The extended Assembler provides four pseudo-ops directly affecting the location 
counter that allow the user to: 

1. Allocate a block storage (.BLK), 

2. Change the value and relocation property of the current location 
counter (. LOC), and 

3. Specify the relocation property of source lines (. ZREL and . NREL). 



. BLK Pseudo-op 
The , BLK pseudo-op 



. BLK A exp 



allocates a block storage, ex£ words in length. The current location counter is 
incremented by exp. If the expression cannot be evaluated in pass 1 or the value 
of the current location counter exceeds 2^^-l, a location (L) error results. 

The following example shows the effect of the .BLK pseudo-op on the 
contents of the location counter. 



0?il25'PSPi?IPi0'? BY03» 

0(50004 BY10» .eUK 4 

000002 BYllI .BUK 2 

00l34'ei?»«300 BY13J CI 
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, LOG Pseudo-op 
The . LOG pseudo-op 



. LOG A exp 



changes both the value and relocation property of the current location counter to 
that of^xp. For example, if the expression evaluates to a zero relocatable 
value, the current location counter is set to that value and subsequent code is 
assembled as zero relocatable. Similarly, when the expression evaluates as 
-J. — 1__ ..^^...^^ ^wiv^>..«.».»*^j.>, vyj. ij_«_(ov>iu>.c, Liic xuv.aLJ.uj.1 »,uuuLcr IS act Lu tiie xionnal 
relocatable or absolute address. 

The following pseudo-op sets the absolute location counter to octal 1400: 



00000' 000010 10 

001400 .ILOC 1400 
01400 103400 ADD 



;NORMAL RELOGATABLE 

;RETURN TO ABSOLUTE LOCATION 1400 



The current location symbol (. ) can be used with the . LOG pseudo-op. Depending 
on the relocation property of the code it is used with, it can mean: "current 

absolute address. " "rnrrpnf nnvmal vplr>r<nt-a>->l«a aHrli-ooo " r^-v " 
relocatable address. " 



WUXX WIXL 



y°S' 



,c ^cxu 



• NREL 



00002*000003 3 

000005*. L)C .+2 
00005*020010 LDA 0,10 



. ZREL and . NREL Pseudo-ops 

In addition to the assembly of absolute code, the programmer can use the Extended 
Assembler to produce two types of relocatable code: zero relocatable and normal 
relocatable. 

Storage words that can be relocated but must reside in page zero should be assem- 
bled using zero relocatable mode. The user informs the assembler that a body of 
code is to be zero relocatable by preceding it with the pseudo-op: 
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. ZREL and . NREL Pseudo-ops (Contd. ) 



ZREL 



Storage words that can be relocated anywhere except page zero must be assembled 
using normal relocatable mode. The user informs the assembler that a portion of 
code is to be normally relocatable by preceding it with the pseudo-op: 



.NREL 



The Extended Assembler initially assumes the assembly mode to be absolute and 
assembles in this mode until it encounters either a . ZREL or . NREL pseudo-op. 
Thereafter, the assembly continues at the next available zero relocatable or 
normal relocatable address. 



00000 000000 AL: 
.2REL 
00000-000000 2: 
00001-000000 2L: 

000100 .LOC 100 
00100 000003 M 

.NREL 
00000*000003 .A: M 
00001'002777 JMP @.A 



;ABSOLUTE 

; ZE RO RE LOGATABLE 

;RETURN TO ABS. TO REMAIN IN ZREL, 
;USE.THE .LOG .+ number 

;NORMAL RELOCATABLE 
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INTERPRQGRAM COMMUNICATION PSEUDO-OPS 

The Extended Assembler provides facilities for separately assembled programs 
to share data, addresses, and symbols. Using the interprogram communication 
pseudo-ops, the programmer can: 

1. Reserve a labeled or unlabeled program area to be shared by several 
programs (. COMM and . CSIZ), 

2. Define entry symbols that can be referenced by other programs (.ENT), 
and 

3. Name a program that is to become an overlay segment (, ENTO)= 

Then using the pseudo-ops .EXTD, .EXTN, .GADD, and .GLOC, programs can 
reference these program areas, entry symbols, and overlays. Because not all 
symbols will be defined at the end of pass 1 if these pseudo-ops are used, the 
Extended Assembler also includes the . EXTU pseudo-op which directs the 
assembler to treated undefined symbols as displacement externals. 

■ COMM Pseudo-op 

The . COMM pseudo-op specifies the name and size of a program area to be used 
for interprogram communication by programs loaded together. The format of 
the pseudo-op is: 



. COMM A usr-sym A exp 



where usr-sym is the name of the area for interprogram communication and exp 
is its size, in words. This area is reserved by the first loaded routine declaring 
the name usr-sym. The area is reserved at NMAX (the first location available to 
load normal relocatable data), immediately preceding any normal relocatable 
code loaded. Other loaded routines declaring usr-sym share this original area, 
provided the sizes specified (exp) are the same. 

Since usr-sym is an entry in the program, it cannot be redefined elsewhere in 
the program. 

The symbol usr-sym can be referenced by other programs loaded together using 
any of the following pseudo-ops: 

.EXTD .EXTN .GADD .GLOC 
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COMM Pseudo-op (Contxl. ) 



.TITL A 
000100 .COMM X« 100 
idf^Qie^Qi .COMM Y/40 
000050 .COMM Z/50 



.END 

.TITL B 
000100 .COMM X, 100 



.END 



Loading would take place as follows: 



nign core ► 


B 


AIs start of NREL_^ 


A 


Z 


50 words 


Y 


40 words 


X 

initial NMAX 


100 words 







.CSIZ Pseudo-cp 

The . CSIZ pseudo-op specifies the size of an unlabeled program area to be used for 
interprogram communication. Its format is: 



. CSIZ A exp 



where exg^is the size, in words of the program area. The Extended Assembler eval- 
uates this e:q)ression and passes the value to the loader. The loader stores this value 
in the User Status Table, at location 410 (USTCS). If more than one . CSIZ pseudo-op 
appears in a program to be loaded, at the termination of the load USTCS is set to the 
largest value specified by all . CSIZ pseudo-ops. 



.TITL X 
000050 .CSIZ 50 



END 



RLDR X 



NMAX 001037 
EMAX 000050 
CS2E 000050 

EST 

SST 



;50 WORDS ALLOCATED BY LOADER 
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.ENTPseudo-op 

A program can define a symbol that can be referenced by separately assembled pro- 
grams by including it in the .ENT pseudo-op line. The .ENT pseudo-op has the format: 



1 ' ' — ~~ 

j .ENT A usr-symj f A usr-sym2. . .Ausr-sym^J 



where each usr-sym is a symbol defined in the declaring program and available to 
other programs. Each usr-sym must be defined with the program in which it is de- 
clared. Each symbol must be unique from entries defined in other programs loaded 
^w^cvxic^ tv* xv>j.i.i.x t* .^icxYv, uLxi^, u. iiv/t, cue xuaucx xsciucs tm cxTor message indicating 
multiply defined entries. Entry symbols can be referenced in separately assembled 
programs using any of the following pseudo-ops: 

.EXTD .EXTN .GADD . GLOC 



.TITLE OVKIL 

.ENT OVKIL, QVKIX 

.EXTD .CPYLf.KTtR 

,EXTN FHET,TOVRL,KlLL 



.NRtL 

v!lij0ill 'i3M604!)2$OVKIL: JSR #.CPYL 

ia0fe)l3iJ'02.J61l LUA PI,#0VNUI1,.3 

000lsS'e!312l^ aVKIX; LDA 2,FRTN,2 

00((3ll 'i52li?l^ll LDA 0#lf2 



. ENTQ Pseudo-op 

If a program is to become an overlay within an overlay segment, the . ENTO 
pseudo-op can be used to name the overlay. The overlay can then be referenced 
from other programs using this name. The format of the . ENTO pseudo-op is: 



.ENTO A usr-sym 



where usr-sym becomes associated with the node number and overlay number 
assigned to the overlay at load time. Programs referencing this overlay must 
include the symbol usr-sym in an , EXTN or . GADD pseudo-op Une. 

Because the order in which overlays are loaded determines the overlay and node 
numbers, usr-sym is assigned a value at load time. For this reason, the symbol 

usr^rm cannot be used elsewhere in the program. 
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.ENTO Pseudo-op (Contd. ) 



Overlay 

.TITL TIME 
.ENTO METER 



Referencing Program 

.TITL ROOT 
.EXTN METER 
.NREL 



ONO: METER 



LDA 0, ONO 
ADC 1, 1 

. TOVLD ;RDOS MULTITASKING LOAD 
; COMMAND 



.EXTDPseudo-op 



A symbol can be defined in one program and referenced in a memory reference in- 
struction or data Une in another program if the referencing program contains the 
. EXTD pseudo-op. The format of the pseudo-op is: 



. EXTD A usr-symi f A usr-sym2- • • ^ usr-sym^ ^ 



where each usr-sym j is a symbol (externally) defined in another program. This 
pseudo-op declares the symbols as displacement externals (or external displace- 
ments). Once a symbol has been declared a displacement external, it can be used 
in either of two ways: (1) as an address or displacement in a memory reference , 
instruction or (2) to specify the contents of a 16-bit storage word. 

When evaluated by the Extended Assembler, displacement externals must resolve 
to a value representable in eight binary digits. This means that: 

1. If used as a page zero address in a memory reference instruction with 
index = 00, or in a data line, the displacement must resolve to a value 
in the range of through 377 (octal), inclusive. 

2. When used in a memory reference instruction with index / 00 (addressing 
relative to the location counter or a base address contained in AC2 or 
AC3), the displacement must resolve to a value in the range of -200 
through 177 (octal), inclusive. 

The program defining the symbol usr-svm must declare it an entry symbol in a 

. ENT or , COMM pseudo-op. , ^„ 
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EXTD Pseudo-op (Contd. ) 






.TITLt 

,feN(T 
.tXTD 

.NR£U 



•.CPYU 



HOLD 
HOLD 
.CPYL 



EXTN Pseudo-op 



With the . EXTN pseudo-op a program can reference a symbol in a data line that 
is defined in another program. The format of the pseudo-op is: 



, EXTN Ausr-symj t Ausr-sym2. . . Ausr-symn^ 



where each usr-sym^ is a symbol (externally) defined in another program. This 
pseudo-op declares the symbol(s) as normal external symbols. Normal externals 
can be used only in data line because an entire storage word must be reserved 
for each symbol. 

The usr-sym must be defined in a separately assembled program and must appear 
in that program in an . COMM, . ENT, or . ENTO pseudo-op. 



.TITLt 
.tXTN 



«0toia7' 177777 

mvilldU/7777 ,iost: 



FRET 
TIOST 



STTSK 
FRET, TIOST 



.£N0 
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.EXTU Pseudo-op 

This pseudo-op causes the assembler to treat all symbols that are undefined after 
pass 1 as if they had appeared in an . EXTD pseudo-op. The format of the pseudo-op 
is: 



.EXTU 



.TITL FRED 
.EXTU 



00006'024001$ LDA 1,UNDEF ;UNDEF IS TREATED AS EXTERNAL 



, GADD Pseudo-op 

The . GADD pseudo-op generates a storage word whose contents is resolved at 
load time. The format of the pseudo-op is: 



. GADD A usr-sym A exp 



where the value of usr-sym Is searched for at load time and, if found, is added 
to the value of exp to form the contents of the storage word. If usr-sym is not 
found, a loader error results and the storage word contains just the value of exp. 

The usr-sym must be defined in a separately assembled program and must appear 
in that program in an . ENT, . ENTO, or . COMM pseudo-op. . GADD can thus be 
used in a similar manner to . EXTN with the following differences; 

1. A user symbol in a . EXTN pseudo-op and used as a storage word is 
resolved regardless of whether the defining program is loaded before 
or after the program containing the . EXTN. 

2. A user symbol in a . GADD block is resolved only if the defining program 
is loaded before the program containing the . GADD block. 
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, GADD Pseudo-op (Contd. ) 



.NREL 



00027'000032' . +3 

00O202 .GADD CLl, 2 ;CL1 MUST HAVE BEEN LOADED AND HAVE A 
00031'000020 20 ;VALUE OF 200 



._ GLOC Pseudo-op 

The . GLOC pseudo-op defines a global location block containing absolute data. Its 
format is: 



, GLOC Ausr-sym 



which begins the block of absolute data origined at the value of usr-sym at load 
time. The block is terminated by the next occurrence of a . LOC, . NREL, . ZREL 
or . END pseudo-op. 

The usr-sym must be defined by an . ENT or . COMM in a "rooram loaded 'rrior 
to the global location block or a fatal load error results. 

The global location block cannot contain external references, label definitions, or 
label references. 



.TITL B 
.GLOC MY AREA 

00000*000001 1 

00001*000002 2 

00002*000003 3 

.NREL 



• END 
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TEXT PSEUDO-OPS 

. TXT. . TXTE, . TXTF, and . TKTO Pseudo-ops 

These text pseudo-ops store ASCII octal equivalents of characters of a string. TTie 
pseudo-ops have the forms: 



. TXT A /string/ 
.TXTE A/string/ 
.TXTF A/string/ 
.TXTO A/string/ 



where string i s a text string of ASCII characters and / represents a character that 
is used to delimit string. 

Any character may be used to delimit string except: 

1. A character that also appears within the string. 

2. Carriage return, space, tab, comma, nuU, line feed, form feed, or rubout. 

Upon encouiitcring a text pseudo-op, the assembler takes the next .si<3iificant charac- 
ter as a delimiter. Thereafter, pairs of characters are assigned to consecutive 
words of memory until the terminating delimiter is encountered. Every two 
characters generate a storage word. If the string contains an odd number of charac - 
ters, the final character is paired with a null. K the string contains an even number 
of characters, a null word is assigned to the location immediately following the string 
(unless the .TXTN pseudo-op, described later, is used). 

Storage of ASCII octal codes requires seven bits of an eight -bit byte. The leftmost 
bit is used to indicate parity, as indicated by the text pseudo-op used: 

.TXT sets the leftmost bit of the byte to unconditionally. 
.TXTE sets the leftmost bit of the byte for even parity on the byte. 
.TXTF sets the leftmost bit of the byte to 1 unconditionally. 
.TXTO sets the leftmost bit of the byte for odd parity on the byte. 

Within the string, any character may be used with the following limitations: 

1. A carriage return or form feed appearing in the string will continue 
the string to the next line or page respectively and willnnot be stored 
as part of the string. 
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TEXT PSEUDO -OPS (contd) 

.TXT, .TXTE, .TXTF, and . TXTO Pseudo -ops 

2. The characters null, line feed, and rubout are not interpreted and 
thus will not be stored if they appear in the string. 

3. The characters < and > are used to delimit characters that would 
otherwise not be stored and, as delimiters, are not stored as part 
of the string. 

The characters listed above that are not normally stored can be introduced as part 
of a text string by enclosing either the octal equivalent of the character or the 
special integer form of the character in angle brackets: 

.TXT ©LINE 1 <t5>@ -« stores carriage return 

.TXT @PENS SELLING <"@> $20/ DOZEN® ^—delimiter stored 
.TXT ©LESS THAN IS WRITTEN AS <"< >. @ wangle bracket stored 

By default, text bytes are packed from right to left; the programmer can change the 
packing mode by using the .TXTM pseudo -op described later. 



00000 041101 .TXT #AB CD# 
041440 
000104 

00003 041101 .TXTE #AB CD# 
141640 
000104 

00006 141301 .TXTF #A8 CD# 
141640 
000304 

00011 141301 .TXTO #AB ZV)# 
041440 
000304 



.TXTN Pseudo -op 



The user can suppress the addition of a null word to a character string containing an 
even number of characters usine the pseudo -op . TXTN. This pseudo -op has the 
form: 
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TEXT PSEUDO-OPS (contd) 
.TXTN Pseudo-op 




where ex£ is any legal expression. The assembler evaluates ej^and performs the fol- 
lowing action. 

Value of exp Assembler Action 



zero 



nonzero 



All subsequent text strings containing an even number of 
bytes are followed by a full word consisting of two zero 
bytes. 

All subsequent text strings containing an even number of 
bytes terminate with the last two bytes of the string. 



The .TXTN pseudo-op has no effect on text string containing an odd number of bytes; the 
last character is always paired with a zero byte. 



000000 .TXTN 
00000 031061 .TXT /1234/ 

032063 
000000 

000001 .TXTN 1 
00003 031061 .TXT /1234/ 

032063 



.TXTM Pseudo-op 

Normally, bytes are packed from right to left. This packing mode can be changed by 
the pseudo-op .TXTM, which has the form: 



. TXTM A exp 



where if the value of ejcgi is 0, bytes are packed right to left and if the value of exp is 
nonzero, bytes are packed left to right. 



TEXT PSEUDQ -OPS (contd) 
.TXTM Pseudo-op (contd) 



000000 .TXTM 
00000 041101 .TXT #AB CD# 

000 1 04 

000001 .TXTM 1 
00003 040502 .TXT #AB CD# 

020103 
042000 
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CONDITIONAL PSEUDO-OPS 

The Extended Assembler provides a conditional assembly feature which allows por- 
tions of a program to be assembled or to be by -passed by assembly on the basis of 
evaluation of absolute expressions. The conditional portion of the program has the 
general form: 



.IFa Aexp 



.ENDC 



where a is one of the letters E, G, L, or N and exp is an absolute expression. To- 
gether a and exp determine the conditions under which assembly will take place. 
The lines following, indicated by the elipsis, are assembled conditionally up to the 
the .ENDC pseudo-op, which terminates conditional assembly. The meaning of the 
letters E , G, L ,. and N is: 

, IFE exp Assemble if exp is equal to . 

.IFG exp Assemble if exp is greater than 0. 

.IFL exp Assemble if exp is less than 0. 

. IFN exp Assemble if exp is not equal to . 

The ejqjression in the .IFE, .IFG, .IFL, or .IFN pseudo-op must be evaluable in 
pass t of the assembly process, that is, all symbols used in the expression must be 
absolute and defined previous to the occurence of the .IFE, .IFG, .IFL, or .IFN. 

Conditional assemblies should not be nested; if a conditional pseudo-op is encoun- 
tered after a .IFa but before an .ENDC, the second conditional pseudo-op is ignored 
and is flagged with a K in the assembly listing. 

If an . END or . EOT pseudo-op is included in conditionally assembled code, it will 
not be ignored. Regardless of the value of the expression with the . IFa , the . END 
or . EOT pseudo-op always terminates the assembly process. For example, in the 
conditionally assembled code: 

.IFE 1 

.END 

.ENDC 

the . END is not bypassed but causes the assembler to cease assembly. 
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CONDITIONAL ASSEMBLY PSEUDO-OPS (contd) 



000000 A=0 
000000 B=A 

.NREL 

000000 .IFE B-2 
LDA 0^A 
.ENDC 

000000 .IFG B-2 
LDA 0*A 
.ENDC 

000001 .IFL B-2 
00000'020000 LDA 0*A 

.ENDC 

000001 .IFN B-2 
00001 '020000 LDA 0*A 
.ENDC 



le expression evaluates to false in these cases, so 
the load instruction is not assembled. 



J 



^The expression evaluates to true in these cases, so 
the load instruction is assembled. 



FILE TERMINATING PSEUDO-OPS 

It is sometimes necessary to continue a program on more than one input source tape. 
The following pseudo-op indicates the end of the input file, but not the end of the 
input source: 




Upon encountering the , EOT pseudo-op, the Extended Assembler stops the source 
input device and halts with a 00006 in the address lights on the programmer's con- 
sole. The assembly can be continued by loading the input device and pressing the 
console CONTINUE switch. 

The .ENDpseudo-op terminates a source program, providing an end -of -program 
indicator for the relocatable loader. The syntax of the . END pseudo-op is: 



.ENDfAexp} 
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FILE TERMP^ATING PSEUDO-OPS (contd) 

v/here exp is an optional argument specifying a starting address for execution. The 
loader initializes TCBPC of the active TCB to the last address, if any, specified by 
a relocatable binary at load time. Execution of the loaded save file begins at this 
address. If the loader finds no starting address among programs loaded, an error 
message is given. 

The following example illustrates the use of the .ENDpseudo-op. 



0i^fe5C"-4'l 7777 7 

177611 PHIO a FT5TH 

«0K^ib'l77777 ,TPRI: 



.TITLE 


FP ■ 


,ENT 


PRI 


,tXTN 


TPH 


.EXTN 


FR 


,tXTD 


.CP' • 


.NRfcL 




1 




JSR 


#.cp- 


LUA 


0,»HRIO,3 


JSH 


•.TPRl 


FH- 




T5TH 




TPK 




,tNU 
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APPENDIX A 



EXTENDED ASSEMBLER CHARACTER SET 



7 -Bit 




7-Bit 




7-Bit 




7 -Bit 




Octal 




Octal 




Octal 




Octal 




Code 


Character 


Code 


Character 


Code 


Character 


Code 


Character 








1 


000 


Null* 


072 


: 


125 


U 


165 


u 


Oil 


Tab 


073 


f 


126 


V 


166 


V 


012 


LF* 


074 


< 


127 


W 


167 


w 


014 


FF 


075 


= 


130 


X 


170 


X 


015 


CR 


076 


> 


131 


Y 


171 


y 


040 


SP 


100 


@ 


132 


2 


172 


ry 


041 


! 


101 


A 


141 


a 


177 


Rubout* 


042 


f r 


102 


B 


142 


b 






043 


# 


103 


C 


143 


c 






046 


& 


104 


D 


144 


d 






052 


* 


105 


E 


145 


e 






053 


+ 


106 


F 


146 


f 






054 


> 


107 


G 


147 


g 






055 


- 


110 


H 


150 


h 






056 


• 


111 


I 


151 


i 






i 057 


/ 


112 


J 


152 


J 






060 





113 


K 


153 


k 






061 


1 


114 


L 


154 


1 






062 


2 


115 


M 


155 


m 






063 


3 


116 


N 


156 


n 






064 


4 


117 





157 









065 


5 


120 


P 


160 


P 






066 


6 


121 


Q 


161 


q 






067 


7 


122 


R 


162 


r 






070 


8 


123 


S 


163 


s 






071 


9 


124 


T 


164 


t 







*These characters are ignored by the Extended Assembler. 
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APPENDIX B 

ASSEMBLY LISTING ERROR CODES 

ERROR CODE MEANING 

A An address error has occurred: (1) an expression evaluates 

to other than an absolute, normal relocatable, or page zero 
relocatable address; (2) a page zero relocatable instruction 
references an address outside page zero; or (3) a normally 
relocatable instruction referenrfis an nHH-rpoa nntcr-Ho t-u^ -^o.,^^ 
of the location counter relative addressing. 

B An illegal character (not in the Extended Assembler character 

set) has been encountered. 

C A colon error has occurred; a label was defined improperly. 

D A radix error has occurred. Possible sources of error include 

an expression that is outside the range ( 2 through 10) of the 
. RDX pseudo-op. 

E An equals sign has been used incorrectly. 

F A format error has occurred. Ibssible sources of error in- 

clude an incorrect number of arguments for an instruction or 
an operator follows a double precision or floating point number. 

G An error has occurred in defining an internal or external symbol. 

I A parity error has occurred on input. 

K A conditional assembly error has occurred: (1) an expression 

used with a . IFE , . IFG, . IFL, or . IFN pseudo -op cannot be 
evaluated in pass 1, or (2) a .IFE, .IFG, .IFL, or .IFN 
pseudo -op is nested within a conditional assembly. 

L A location counter error has occurred. An attempt was made to 

set the location counter to an illegal value. 



M 



A symbol has been defined more than once. 



N A number error has occurred. Possible sources of error 

include (1) a letter directly follows a number, (2) a digit 
has been used that is greater than the current radix, or (3) 
a number is too large or too small to be represented as a 
floating point number. 
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ERROR CODE MEANING 

O A field overflow has occurred. 

P A phase error has occurred; the value of a symbol in pass 

2 differs from that of pass 1. 

Q A source statement is questionable. The Extended 

Assembler is not able to evaluate a source line. 

R An expression error has occurred: (1) an expression does 

not evaluate to be absolute, relocatable, or byte relocat- 
able: or (2) any expression combines normal and page 
zero relocatable symbols incorrectly. 

S The symbol table capacity has been reached, 

T A symbol table pseudo-op has been specified incorrectly. 

U A symbol is undefined. 

X A text error has occurred. 

Z An expression contains an illegal operand such as an 

external symbol, instruction mnemonic, double precision 
number, or floating point number. 
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APPENDIX C 



EXTENDED ASSEMBLER PSEUDO-OPS 



FUNCTION AND 
MNEMONIC 


SYNTAX 


USE 


Title 

.TITL 


.TITT.A usr-sym 


Names a program. 


Number Radix 
.RDX 


. RDX Aexp 


Defines the radix exp to be 
used for numeric conversion: 
2<exp< 10 (decimal) 


Symbol Table 
. DALC 

• DIAC 

• DIO 
.DIOA 
.DMR 
.DMRA 

• DUSR 


. DALC A sym = exp 
. DIAC A sym = exp 

. DIO A sym = exp 

. DIOA A sym = exp 

. DMR A sym = exp 

. DMRA A sym = exp 

. DUSR A sym = exp 


Defines a symbol as an arith- 
metic or logical instruction. 

Defines a symbol as an in- 
struction requiring an 
accumulator. 

Defines a symbol as an input/ 
output instruction without an 
accumulator field. 

Defines a symbol as an input/ 
output instruction requiring 
an accumulator. 

Defines a sjnnbol as a memory 
reference instruction without 
an accumulator field. 

Defines a symbol as a mejnory 
reference instruction requir- 
ing an accumulator. 

Defines a user symbol. 
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EXTENDED ASSEMBLER PSEUDO-OPS (cont. ) 



FUNCTION AND 
MNEMONIC 


SYNTAX 


USE 


Symbol Table (cont. ) 
.XPNG 


.XPNG 


Removes all symbols, except 
permanent symbols, from the 
symbol table. 


Lx) cation Counter 
.BLK 

.LOC 

.NREL 
.ZREL 


. BLK A exp 
. LOC A exp 

.NREL 

.ZREL 


Allocates a block of storage 
exp words in length. 

Changes the value and loca- 
tion property of the current 
location counter to that of 
exp. 

Specifies that subsequent 
source lines are to be 
assembled using normally 
relocatable addresses. 

Specifies that subsequent 
source lines are to be 
assembled using page zero 
relocatable addresses. 


Interprogram 
Communication 

.COMM 

.CSIZ 

.ENT 


. COMM A usr-sym A exp 

. CSIZ A exp 

.ENT A usr-sym .. . 


Reserves an area exp words 
in length with the name usr- 
sym for interprogram 
communication. 

Reserves exp words for inter- 
program communication. 

Specifies that each usr-sym. 
is an entry point that can be 
referenced by other programs. 
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EXTENDED ASSEMBLER PSEUDO-OPS (cont. ) 



FUNCTION AND 
MNEMONIC 



Interprogram 
Communication (cont. ) 

.ENTO 



.EXTD 



SYNTAX 



.EXTN 



EXTU 



GADD 



. ENTO A usr-sym 



EXTD A usr-sym ... 



EXTN A usr-sym . . . 



.EXTU 



. GADD A usr-sym A exp 



.GLOC 



, GLOC A usr-sym 



USE 



Associates usr-sym with the 
node and overlay numbers 
assigned to the overlay. 

Specifies that each usr-sym. 
is a displacement external 
that is defined in another 
program. 

Specifies that each usr-sym. 
is a normal external that is 
defined in another program. 

Specifies that all symbols 
undefined after pass 1 are 
to be treated as if they were 
in an .EXTD pseudo-op. 

Generates a storage word 
whose contents is, at load 
time, usr-sym + exp. usr- 
sym must be defined in a 
separately assembled program. 

Begins a block of absolute data 
starting at the value of usr - 
sym up to the next . LOG, 
.NREL, .ZREL, or .END. 



Text 



.TXT 



, TXT A #string# 



.TXTE 



, TXTE A #string# 



Stores the ASCII code for each 
byte in the text string. Left- 
most bit of each byte is set to 
zero. 

Stores the ASCII code for each 
byte in the text string. Left- 
mpst bit of each byte is set for 
even parity. 
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EXTENDED ASSEMBLER PSEUDO-OPS (cont. ) 



FUNCTION AND 
MNEMONIC 


SYNTAX 


USE 


Text (cont. ) 
.TXTF 

. TXTM 

.TXTN 
.TXTO 


. TXTF A #string# 
. TXTM A exp 

. TXTN A exp 
.TXTOA#string# 


Stores the ASCII code for each 
byte in the text string. Left- 
most bit of each byte is set to 
one. 

Defines the packing of bytes for 
other text pseudo-ops: 

exp = bytes are packed 

right to left, 
exp^ bytes are packed 
left to right. 

Suppresses a terminating null' 
word, normally appended to an 
even number of text bytes. 

Stores the ASCII code for each 
bjte in the text string. Leftmost 
bit of each byte is set for odd 
paritv. 


Conditional Assembly 
.ENDC 

.IFE 
• IFG 
.IFL 
.IFN 


.ENDC 
. IFE A exp 

.IFG A exp 

. IFL A exp 

.IFNAexp 


Terminates a group of lines of 
conditional assembly. 

Specifies that subsequent lines 
up to .ENDC are assembled if 
exp = p. 

Specifies that subsequent lines 
up to .ENDC are assembled if 
exp >0. 

Specifies that subsequent lines 
up to .ENDC are assembled if 
exp <p . 

Specifies that subsequent lines 
up to .ENDC are assembled if 
exp 7^0. 
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EXTENDED ASSEMBLER PSEUDO-OPS (contd. ) 



FUNCTION AND 
MNEMONIC 



File Terminating 
.END 



,EOT 



SYNTAX 



.ENDf exp} 



,EOT 



USE 



Terminates a source program 
and OTitionallv i^rovides a 
starting address for execu- 
tion. 

Indicates the end of an input 
tape but not the end of the 
source file. 
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APPENDIX D 
OPERATING PROCEDURES 



This appendix describes the procedures for operating the Extended Assembler 
under control of the Real Time Disk Operating System (RDOS) and the Stand-Alone 
Operating System (SOS) as well as in stand-alone mode, without operating system 
intervention. 

The input to and output from the assembler are described in Chapter I. Appendix 
E describes the format of the relocatable binary output from the assembler that 
must be input to the extended relocatable loader. Operation of the loader is 
described in the Extended Relocatable Loaders User's Manual , document number 
093-000080. ~ 
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RDOS OPERATING PROCEDURES 

One or more source files can be assembled by the RDOS Extended Assembler using 
the CLI command: 



ASM filename 1 . . . filename^j ) 



Input to the assembler must be ASCII source files. Output can be a relocatable 
finary file, a listing file, or both. 



Switches 



Global: 



Local: 



The following switches can be appended to the ASM command name. 

/L Produce a listing file. 

/N Do not produce a relocatable binary file. 

/U Include local (user) symbols in the relocatable binary output. 

/E Suppress £rror messages. 

/S Skip pass two. A BREAK is signaled after pass one, permitting 
the user to save a version of the assembler containing user 
semi-permanent symbols. 

/T Do not produce a symbol table list as part of the listing. (If 
a listing is requested, a symbol table is produced by default; 
this switch must be used to suppress the symbol table. ) 

/X Produce a cross reference list of the symbol table. 

The following switches can be appended to a file name. 

/B Output the relocatable binary to the specified file name. 

/E Output error messages to the specified file name. 

/L Output the listing to the specified file name, overriding the 
global /L. 
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Switches (Continued) 

/S Skip this file on pass two. (This switch should be used only if 
the file does not assemble any storage words. ) 

/N Do not list the specified file. (This switch is used when a 

listing is requested and only a selected number of files are to 
be assembled. ) 

File Name Searches 

For input files, a search is performed first for filename. SR. If it is not found and 
filename has no extension, a search is then made for filename. On output, a re- 
locatable binary file, filenam.e . R.B and a listing file (if the global /L switch is 
specified), filename . LS, are produced; filename is the first source file specified 
without a /S, /L, or /B local switch. 

Caution 

The following command would cause the loss of the first relocatable binary disk 
image : 

ASM ($PTR, $PTR) $LPT/L 

Although two distinct source files are read by the high-speed reader, each reloca- 
table binary produced is labeled $ITR. RB. Thus, the first relocatable binary is 
overwritten by the second. 

Error Messages 

The following error messages may be produced during assembly. 

Message Meaning 

NO SOURCE FILE SPECIFIED. No input source file was specified in 

the command line. 

ILLEGAL FILE NAME. A file name is illegaL 

FILE DOES NOT EXIST. An input source file does not exist. 

FILE ALREADY EXISTS. An output file already exists. 
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Error Messages (Continued) 
Message 
FILE WRITE PROTECTED. 

FILE READ PROTECTED. 

SWITCH ERRORS 

Examples 
1. 



Meaning 

An attempt has been made to write to a 
write -protected output file. 

An attempt has been made to read from 
a read- protected input file. 

The same file has been specified for 
both the listing and binary files. 



The following command line assembles source file Z, producing the re- 
locatable binary file Z. RB. 

ASM Z ) 

This command line assembles file A, producing a listing file A. LS. 

ASM/N/L A ) 

The following RDOS command assembles files A, B, C, and D from the default 
directory, of file E on fixed head disk unit and paper tape mounted on the 
high-speed reader. (The source program mounted on the reader must be 
reloaded since the assembler requires two passes. ) Binary relocatable files 
for each source file are output on the high-speed punch. Separate assembly 
listings are produced on the line printer. 

ASM(A,B,C,D,DKO:E,$PTR) $PTF/B $LPT/L 
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SOS OPERATING PROCEDURES 

The SOS Extended Assembler assembles one or more ASCII source files and 
produces a relocatable binary file with an optional listing file. The assembler can 
be loaded from paper tape; once loaded the assembler prints the prompt: 

ASM 
The user must respond with a command line of the form: 



filename, . , . filename^ 
J- n 



where: 0, 1, and 2 are keys describing the number of passes to be performed: 

Perform one pass only on the specified input source file(s), then 
halt with the highest symbol table address in ACO. Normally, 

if this key is used, the input source is a Command Definition 
tape. The core image writer can then be called to preserve a 
copy of this assembly, 

1 Perform two passes on the specified input source file(s), 
producing the specified binary and listing files. At the comple- 
tion of pass two, the assembler outputs a new prompt and 
awaits a new command line. 

2 Perfrom pass two only on the specified input source file(s), pro- 
ducing the specified binary and listing files. The symbol table 
used for this pass is that produced by the most recently executed 
pass one assembly. At the completion of this pass, the 
assembler outputs a new prompt and awaits a new command line. 

filename j^ . . . filenamCj^ are file or device names specifying input or 
output files. Input to the assembler must be ASCII source files. 
Input files are assembled in the order specified in the command 
line, from left to right. A cassette or magnetic tape unit can- 
not be used for both input and output or for more than one out- 
put file. However, a cassette or magnetic tape unit can be used 
for more than one input file. 
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Switches 

Global : The following switches can be appended to the numeric keys at the be- 

ginning of the command line. 

/E Suppress assembly error messages normally output to the $TTO. 

/T Suppress symbol table listing. 

/U Include local (user) symbols in the binary output file. 

Local: The following switches can be appended to a file name. 

/B Output the relocatable binary file on the specified device. 

/L Output the listing file on the specified device. 

/N Do not list the specified file on pass two. 

/P Pause before accepting a file from the specified device. The 
following message is output by the assembler: 

PAUSE - NEXT FILE, devicename 

Assembly does not continue until the user depresses any key on 
the teletypewriter console. 

/S Skip the specified source file on pass two. 

/n Repeat the specified source file n times, where n is a digit 
from 2 through 9. 

Error Messages 

The following error messages may be produced during assembly. 

Message Meaning 

I/O ERROR 1 A filename is illegal. 

I/O ERROR 7 An attempt was made to read from a 

read-protected input file. 
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Error Messages (Continued) 
Message 
I/O ERROR 10 

I/O ERROR 12 
NO .END 



Meaning 

An attempt was made to write to a write- 
protected output file. 

File does not exist. 

No . END statement was found in any 
source file. 



Examples 

1. The following command line executes a two-pass assembly using cassette 
files 0, 1, and 2 on unit as input. A binary file is produced on unit 1, 
file 0; a listing file is printed on the line printer. On pass 2, input file 
CTO:0 is skipped and input file CT0:2 is not listed. 

1 CT1:0/B $LPT/L CTO:0/S CT0:1 CT0:2/N ) 

2. The following command executes the second pass of an assembly using input 
files 13, 14, 18, and 8 (in that order) on cassette unit 0. The binary, con- 
taining user symbols, is produced on file 1 of cassette unit 1; the listing is 
produced on file of cassette unit 2. 

2/U CT0:13 CT0:14 CT0:18 CT0:8 CT1:1/B CT2:0/L ^ 

3. This command line executes a two-pass assembly on input files CT0:16, 
CT0:17, CT1:0, and CT1:1 with a listing printed on the line printer. Error 
messages normally output to the $TTO are suppressed; no binary file is 
produced. 

1/E CT0:16 CT0:17 CT1:0 CT1:1 $LPT/L ) 

4. This command executes a two-pass assembly on two files, both read from unit 
0. The first file is a parameter list to be read during the first pass only. 
After this parameter list is read, the pause message is output, and a new file 
must be placed in cassette unit 0. The first file of this new reel is scanned 
for both passes to complete the assembly. File 1 of unit 1 receives the binary 
output; no listing is produced. 

1 CTO:0/S CTO:0/P CT1:1/B ) 
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STAND-ALONE OPERATION 

The assembler can be loaded from paper tape using the binary loader. Once 
loaded, the assembler requests information of the user concerning input/output 
devices and assembly mode. The user must respond to these queries with a single 
digit. The assembler queries and appropriate responses are given below. 



Query 



User Response and Meaning 



IN: 



LIST: 



BIN: 



Input device is one of the following: 

1 Teletypewriter reader without parity checking 

2 Teletypewriter reader with parity checking 

3 High-speed paper tape reader without parity 
checking 

4 High-speed paper tape reader with parity checking 

5 Teletj^writer keyboard without parity checking 

Listing device is one of the following: 

1 Teletypewriter Model 33 printer 

2 Teletypewriter Model 35 printer 

3 Line printer 

4 Teletypewriter Model 33 paper tape punch 

5 Teletypewriter Model 35 paper tape punch 

Output device for relocatable binary (object tape) is one of 
the following: 

1 Teletypewriter punch without local symbols 

2 High-speed paper tape punch without local symbols 

3 Teletypewriter punch with local symbols 

4 High-speed paper tape punch with local symbols 



MODE: Assembly mode is one of the following: 

1 Perform pass 1 only 

2 Perform pass 2 only and output an object tape 

3 Perform pass 2 only and output a listing 

4 Perform pass 2 only and output an object tape and 
listing. (In this case, the same device cannot be 
used for both the object tape and listing. ) 



D-8 



RTOS OPERATION 

To assemble one or more relocatable binaries, either the RDOS Extended Assembler 
or the SOS Extended Assembler may be used. Procedures for each have been given 
previously in this appendix. 

To load and execute relocatable binaries under RTOS, follow the procedures given 
in Appendix B of the RTOS Manual, 093-000056. As described there, the relocatable 
binaries may be loaded using the (1) SOS relocatable loader, (2) RDOS relocatable 
loader, or (3) stand-alone relocatable binary loader. 



D-9 



APPENDIX E 



RELOCATABLE BINARY BLOCK TYPES 



The relocatable binary output of the Extended Assembler is divided into a series 



,* Ul«„U^ TU^ _-.J„_ _£ tl 1_1__1._ :r 1. 



ui jjiUL-js^o. inc uiuci (jj. uic jjiutK.s, 11 ettcii Lype lb present, is snown m rigure h-j.. 



Title Block 



Labeled Common Blocks 



Entry Blocks 



Unlabeled Common Blocks 



External Displacement Blocks 



Relocatable Data Blocks 

Global Addition Blocks 

Global Start and End Blocks 



Normal External Blocks 



Local Symbol Blocks 



Start Block 



Figure E-1. Order of Relocatable Binary Blocks 
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The relocatable binary output must contain at least a Title and Start Block. 
Presence of one or more of the other types of blocks depends upon source input. 

Every block contains the following information: 

Word Contents 

1 Type of block, indicated by the following octal values: 
Value Block Type 

2 Relocatable Data Block 

3 Entry (. ENT) Block 

4 External Displacement (. EXTD) Block 

5 Normal External (. EXTN) Block 

6 Start Block 

7 Title (.TITL) Block 

10 Local Symbol Block 

11 Library Start Block 

12 Library End Block 

13 Labeled Common (.COMM) Block 

14 Global Addition (. GADD) Block 

15 Unlabeled Common Size (. CSIZ) Block 

16 Global Location Start Block 

17 Global Location End (.GLOC) Block 

2 Word count, in two's complement format, never exceeding 
15. If the word count is a constant for every block of the 
tj^je, the word count is shown in parentheses in the format 
of the block. 

SrS Relocation flags or zero. The relocation property of each 

address, datum, or symbol is defined in three bits. For 
example, for a Relocatable Data Block, bits through 2 of 
word 3 apply to the address, bits 3 through 5 apply to the first 
first word of data, bits 6 through 8 apply to the second word 
of data, etc. The meaning of the settings of three bits are as 
follows : 
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Bits Meaning 

000 Illegal 

001 Absolute 

010 Normal Relocatable 

Oil Normal Byte Relocatable 

100 Page zero Relocatable 

101 Page zero Byte Relocatable 

110 Data Reference External Displacement 

111 Illegal 

If a block does not use relocation flags, these words are 
set to zero, 

6 Checksum, such that the sum of all words in the block is 

zero. 

Additional words in the block vary with block type. 

For blocks containing user symbols, each symbol entry is three words in length. 
The first 27 bits of the three -word entry contain the user symbol name in radix 
50 form. (Appendix F contains an explanation of radix 50 notation. ) The last five 
bits of the second word are a symbol type flag. The meaning of the bit settings 
are as follows: 



Bits 


Meaning 


00000 


Entry Symbol 


00001 


Normal External Symbol 


00010 


Labeled Common 


00011 


External Displacement Symbol 


00100 


Title Symbol 


00101 


Overlay Symbol 


01000 


Local Symbol 



The setting of the third word for each symbol entry varies with the block type. 

The following pages show the format of each block type, arranged numerically 
by block type. 
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RELOCATABLE DATA BLOCK 



Word 







2 


1 


word count 


2 


relocation flags 1 


3 


relocation flags 2 


4 


relocation flags 3 


5 


checksum 


6 


address 


7 


data 


8 


data 


9 


• 
• 
» 


• 
• 
• 


data 


word count +6 



Contents of the relocation flag words (words 3 through 5) are as described 
previously. 

ENTRY BLOCK (.ENT) 



Word 







3 


1 


word count 


2 


relocation flags 1 


3 


relocation flags 2 


4 


Ire location flags 3 


5 


checksum 


6 


1 symbol in 


7 


; radix 50 1 flags 


8 


equivalence 


9 


• 
• 
• 


• 
• 


symbol in 




radix 50 flags 




equivalence 


word count +6 



E-4 



ENTRY BLOCK (.ENT) (Continued) 

Note that the relocation flags for the Entry Block are as previously described, 
except that they apply to the third word of every user symbol entry. For Entry 
Block user symbols, the third word of the user symbol entry is used for the 
equivalence of entry symbol. 



T?X7rni^ i _ ^1. 



ty .j:.iN n^ la uie Hume as me . £,im except for different flag 
values in word SI (word 8, etc. ). 



EXTERNAL DISPLACEMENT BLOCK (. EXTD) 



Word 







4 


1 


word count 


2 


6 


3 


6 


4 


6 


5 


checksum 


6 


symbol in 


7 


radix 50 flags 


8 


077777 


9 


• 


• 


symbol in 




radix 50 flags 




077777 


word count +6 



The third word of each user symbtol entry in the External Displacement Block is 
set to 07'7777. 
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NORMAL EXTERNAL BLOCK (. EXTN) 



Word 







5 


1 


word count 


2 


relocation flags 1 


3 


relocation flags 2 


4 


; relocation flags 3 


5 


i checksum 


6 


symbol in 


7 


radix 50 flags 


8 


■ adr. of last reference 


9 


■ 

• 
• 


• 


symbol in 




radix 50 flags 




adr. of last reference 


word count +6 



The third word of each user symbol entry in the Normal External Block contains 
the address of the last reference. Relocation flags are used as in . ENT blocks. 



START BLOCK 



Word 







6 


1 


word count (-1) 


2 


relocation flags 1 


3 





4 





5 


checksum 


6 


address 


7 
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TITLE BLOCK (. TITL) 



Word 







7 


1 


word count (-3) 


2 





3 





4 





5 


checksum 


6 


title in 


7 


radix 50 flags 


8 





9 



The third word of the user symbol entry for a title is set to 0. 



LOCAL SYMBOL BLOCK 



Word 







10 


1 


word count 


2 


relocation flags 1 


3 


relocation flags 2 


4 


relocation flags 3 


5 


checksum 


6 


symbol in 


7 


radix 50 flags 


8 


equivalence 


9 


• 
• 
* 


« 
• 
• 


sjmibol in 




radix 50 flags 




equivalence 


word count +6 



The third word of every symbol entry is used for the equivalence of local symbols. 
Relocation flags are used as in . ENT blocks. 
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LIBRARY START AND END BLOCKS 

The format of the Library Start and Library End Blocks differs from the format of 
other relocatable binary blocks, since the blocks are not generated by the assembler 
and are thus not internal to the binary output program but mark the beginning and 
termination of a file of binary output programs that constitutes a library file. 



Library Start Block 



Word 



Library End Block 



11 



•11 



1 
2 
3 

4 
5 
6 



12 







■12 



LABELED COMMON BLOCK (. COMM) 



Word 







13 


1 


word count (-4) 


2 


relocation flags 1 


3 





4 





5 


checksum 


6 


symbol in 
radix 50 flags 


7 
8 





9 


expression value 


10 



Bits - 2 of the relocation flags (word 3) apply to the expression ( exp following 
. COMM). All other bits of the word are zeroed. 
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Word 







14 


1 


word count (-5) 


2 


relocation flags 1 


3 





4 





5 


checksum 


6 


address 


7 


symbol in 


8 


i radix 50 i 00000 


9 





10 


expression value 


11 



Bits - 2 of the relocation flags (word 3) apply to the address and bits 3-5 apply 
to the expression. All other bits of the word are zeroed. 



UNLABELED COMMON SIZE BLOCK (.CSIZ) 



Word 







15 


' 1 


word count (-1) 


2 


relocation flags 1 


3 





4 





5 


checksum 


6 


expression value 


7 



Bits - 2 of the relocation flags (word 3) apply to the expression (exp) following 
the .CSIZ pseudo-op. All other bits of the word are zeroed. 
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GLOBAL LOCATION START AND END BLOCKS (.GLOC) 



Start Block 



16 







checksum 



symbol in 

radix 50 1 00000 




Word 


End Block 


1 


17 


2 


-1 


3 





4 





5 





6 


17 


7 
8 
9 
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APPENDIX F 
RADIX 50 REPRESENTATION 



Radix 50 representation condenses symbols of up to five characters into two words 
of storage using only 27 bits. Each symbol, consisting of from one through five 
characters, is representable as: 

^4^3a2^1^0 
where each a. can be one of the following characters: 

A through Z 

through 9 

If necessary, all symbols are padded with nulls to make a five -character symbol. 
Each character is then translated into an octal representation, as follows: 

Character a ; Octal Translation b | 

null 

through 9 1 through 12 

A through Z 13 through 44 

45 

Then, if a. is translated to b|, the bits required to represent the symbol can be 
computed as follows: 

Nj - ((b4*50+b3) *50) + b2 

3 
'^Imaximum ~ ^^ " ■*■ "^ 174777, which can be represented in 16 bits (one word). 

N2 = (bi*50) + bQ 

2 
^2maximum "^ ^^ ~ ^~ ^0^^' which can be represented in 11 bits. 

Thus, the symbol can be represented in 27 bits of storage, as shown in Appendix B 
in the binary output block formats. 
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Where there are a large number of page references for a given 
topic, the primary page reference will be indicated by an asterisk 
(*) following the reference. 



\ 



or 3-1, 4-1*, 4-5 

and 3-1, 4-1*, 4-5 

addition 3-1, 4-1*, 4-4 

subtraction 3-1, 4-1*, 4-4 

multiplication 3-1, 4-1*, 4-4, 4-5 

division 3-1, 4-1*, 4-4, 4-5 

angle brackets 6-2 5 

relocation flag 1-4 , 5-5 

special atom 3-8*, 5-2 

special atom 2-2, 3-8*, 5-5, 5-8 

carriage return 

effect in special integer 3-8 
line terminator 3-1, 3-2 
notation convention i 

form feed line terminator 3-1, 3-2 

Icibel indicator 2-4 
break atom 3-1 

break atom 3-1 
comment indicator 2-4 



relocation flag 1-4 
special atom or integer 3-8 

equivalencing line 2-3 
relocation flag 1-4 

break atom 3-1 
notation convention i 
relocation flag 1-4 

relocation flag 1-4 

character in symbol 3-5 
decimal number indicator 3-2 
decimal point 3-4 
permanent symbol 3-6, 6-15, 6-16 

breeik atom 3-1 

incorrect parity character 2-1 

elipsis convention i 



\ }• optional convention i 

A error code B-1 , 5-5 

absolute 

address 5-4, 5-5 

address in MR 5-5 

value of expression 4-3ff 

accumulator 

in ALC instruction 5-3 

in I/O instruction 5-11, 5-13 

in MR instruction 5-8 

ADC 5-2 

ADD 5-2 
addition 4-lff 
addressing 5-4ff 

ALC instruction (see arithmetic and logical) 
alphabetic 

in symbol 3-5 

lower case translation to upper 
case 2-1 

AND 5-2 

ANDing 3-1, 4-1* 

angle brackets 6-25 

apostrophe relocation flag 1-4 

arithmetic and logical instruction (ALC) 
# sign used for no load in 5-2 
defining semi -permanent symbol 

for 6-7 
definition of 5-2 
format 5-2 

ASCII 

character conversion 3-7 
character set A-1 
input to assembler 2-1 

assembler 

command line invoking D-2 

definition 1-1 

error codes App^ B 

files that make up the Chapter 1 

assembly 

definition of 1-1 

output of 1-2 ff 

cross reference listing 1-4 

error listing 1-3 

program listing l-3ff, 1-6 



Index 1 



asseinbly (cont'd) 

relocatable binary file 1-5 
processing input Chapt. If Chapt. 2 

atoms 

break atoms 3-1 
definition of 3-1 
numbers 3-2ff 
operators 3-1 
special 3-7 
symbols 3-5 
terminators 3-1 

B 

bit alignment operator 3-1, 4-2* 
error code B-1*, 2-1, 3-5 
local switch D-2 , D-6 

bad character error B-1*, 2-1, 3-5 

bit alignment 3-1, 4-2* 

.BLK 6-14 

block 

entry (.ENT) E-4 

external displacement (.EXTD) E-5 

external normal (.EXTN) E-6 

global addition (.GADD) E-9 

global start and end (.GLOC) E-10 

labeled COMMON (.COMM) E-8 

library start and end E-8 

local symbol E-7 

overlay (.ENTO) E-4, E-5 

relocatable data E-4 

start E-6 

title (.TITL) E-7 

unlabeled COMMON (.CSIZ) E-9 

break atom 3-1 

busy/done bit 5-9 

byte 

packing 6-26 
relocatable value 4-3 
termination of string 6-24 to 6-26 
to store character 6-2 4 



carry field of ALC 5-3 

error code B-1 

pulse field of I/O 5-10 

carriage return 

as break atom 3-1 
as line terminator 3-2 
in text string 6-24, 6-25 
notation convention i 

carry field of ALC 5-2 

character 

in symbol 3-5 

set A-1 

storage of strings of 6-24 



checksum of block App. E 

colon 2-4*, 3-1 

COM 5-2 

.COMM 6-17*, E-8 

comma 3-1 

command line for assembly App. D 

comment 2-4 

conditional assembly 
error code B-1 
.IFE, .IFG, .IFN, .IFL, .ENDC 6-28 

CPU 5-13 

cross reference listing 1-4 

.CSIZ 6-18*, E-9 

D 

do'jble precision flag 3-3 
error code B-1 

.DALC 6-5, 6-7*, 5-1 

data line 2-2 

data, relocatable block E-4 

decimal point 6-2 , 3-4 

device code field of I/O 5-9ff 

DIA 5-11 

.DIAC 5-1, 6-12* 
DIB 5-11 
Die 5-11 

.010 5-1 , 6-10* 

.DIOA 5-1 , 6-11* 

displacement 

external 6-20, E-5 
field of MR 5-4ff 
symbol in .EXTD 6-20 

division 3-1, 4-1*, 4-4, 4-5 

.DMR 5-1, 6-8* 

.DMRA 5-1, 6-9* 

DOA 5-11 

DOB 5-11 

DOC 5-11 



Index 2 



dullar sign 1—4 

done/busy bit 5-9 

double 

precision flag 3-3 
precision integer 3-3 

rvo»» c j« 
w^£j J — "* 

.DUSR 6-13*, 5-1 

E 

effective address 5-4ff 
error code B-1 
flocitin" T^oint indicator 3—3 
global switch D-2, D-6 
local switch D-2 



effective add 
end 



^C^kSO 



of input file (.EOT) 6-29 
of program (.END) 6-29 



.ENDC 6-28 
.ENT 6-19 
.ENTO 6-19 
entry 



block E-4 

naming (.ENT) 6-19 

.EOT 6-29 

equal sign 2-3, 1-4 

equivalence line 2-3 



command line D-3 , D-6 
file output 1-3 
output codes 



A 


B-1 


B 


B-1 


C 


B-1 


D 


B-1 


E 


B-1 


F 


B-1 


G 


B-1 


I 


B-1 


K 


B-1 


L 


B-1 


M 


B-1 


N 


B-1 





B-2 


P 


B-2 


Q 


B-2 


R 


B-2 


S 


B-2 


T 


B-2 


U 


B-2 


X 


B-2 


z 


B-2 



evaluation of expression Chapt. 4 

expression 

definition 4-1 

evaluation 4-2 

format 4-1 

operators of 4-1 

relocation properties of 4-3 ff 

.EXTD 6-20*, E-5 

external 

blocks E-5, E-6 

displacement (.EXTD) 6-20*, E-5 

normal (.EXTN) 6-21*, E-6 

•EXTN 6-21*, E-6 



F error code B-1*, 3-6, 6-5 

field of instruction 
ALC 5-2 

implied by semi-permanent symbol 6-3 ff 
I/O with accumulator 5-11, 5-12 
I/O without accumulator 5-9, 5-10 
I/O without device code 5-13, 5-14 
MR with accumulator 5-8 
MR without acciimulator 5-4 
overflow error in 6-5 



file 



flag 



relocatable binary 1-5 
termination of 6-29 



error App. B 
relocation 1-4 



floating point number 3-4 

form feed line terminator 3-1, 3-2 

format error 3-6, B-1*, 6-5 

G error code B-1 

.GADD 6-22*, E-9 

global 

addition block E-9 
start and end blocks E-10 
switch D-2 , D-6 
symbol 3-7 

.GLOC 6-23*, E-10 

HALT 5-14 

horizontal tab 3-1 



Index 3 



I error code B-1 

.IFE 6-2 8 

.IFG 6-28 

.IFL 6-28 

•IFN 6-28 

INC 5-2 

inclusive OR 3-1 

indirect ^ddressinc? 5—5 

input 

error code B-1*, 2-1 
to assembly 1-2 ff 

instruction 

definition 5-1 
format 

ALC 5-2 

I/O with AC 5-11 

I/O without AC 5-9 

I/O without device code 5-13 

MR with AC 5-8 

MR without AC 5-4 

without argument fields 5-14 
line 2-3 
mnemonic 3-6 
types of 5-1 

INTA 5-13 

INTDS 5-14 

integer 

ASCII conversion to 3-7, 3-8 
core representation 3-2 
double precision 3-3 
single precision 3-2 

INTEN 5-14 

interprogram communication pseudo-ops 6- 

lORST 5-14 

ISZ 5-4 

JMP 5-4 
JSR 5-4 

K error code B-1 



error code B-1 
global switch D-2 
local switch D-2, D-6 
shift field of ALC 5-2, 5-3 



label 2-4 

labeled COMMON E-8 

LC 3-6, 2-2*, 5-5, 6-15 

LDA 5-8 

library start and end blocks E-8 

line, source 

comment 2-4 
data 2-2 
equivalence 2-3 
formatting 2-5 
instruction 2-3 
label 2-4 
pseudo-op 2-3 

line feed character 2-1 

line of source input 1-3 » Chapter 2 

listing 

cross reference 1-4 
error 1-3 
program l-3ff 

loading App. D 

•LOC 6-15 

local switch D-2, D-6 

local symbol 3-7, E-7 

location counter 

absolute, ZREL, or NREL 6-15 

definition 2-2 

in MR addressing 5-4 

in program listing 1-3 

incrementing the 2-2, 2-3 

relation to label 2-4 

setting the 6-15 

value (.) 3-6, 6-15, 6-16 

17 M error code B-1 

machine language 1-1 

.MAIN 6-2 

memory reference instruction (MR) 
fields of 5-4ff 
format 5-4 
illegal address in B-1 

mode in MR instruction 5-4 

MOV 5-2 

MSKO 5-13 

multiplication 3-1 

multiply defined symbol error B-1 

Index 4 



error code B-1 
global switch D-2 
local switch D-3, D-6 

named COMMON E-8 

nandng a program 6-2 

NEG 5-2 

NIO 5-9 

no load of ALC 5-3 

normal external B— 6 - 6—21* 

normal relocation (NREL) 
constant 4-3 
location counter 6-15 
pseudo-op ( .NREL) 6-15 
value of expression 4-3ff 

notation conventions of manual i 

•NREL 6-15 

null character 2-1 

number 

character in symbol 3-5 
class of atom 3-2 
double precision integer 3-3 
error B-1 
floating point 3-4 
internal representation 3-2,3-3,3-4 
single precision integer 3-2 
source representation 3-2,3-3,3-4 
special format integers 
(atoms) 3-7, 3-8 



carry field of ALC 5-2 , 5-3 
error code B-2*, 6-5 

operand 4-1 

operating procedures App. D 

operation code 3-6 

operator 

as class of terminals 3-1 
list of 4-1 

ORing 3-1 

output of assembly l-2ff, App. E 

overflow error 6-5, B-2 

overlay (.ENTO) E-4, E-5, 6-19* 



error code B-2 

local switch D-6 

pulse field of I/O 5-10 

packing of bytes 6-26 

page zero relocation (ZREL) 

Willis uoiii- t— J 

in MR 5-5 

location counter 6-15 

pseudo-op (.ZREL) 6-15 

parity 

error code for incorrect B-1 

in text string 6-24 

listing character (\) error 2-1 

pass, aissembly 1-2 

permanent symbols 

3-6, 6-15, 6-16 
pseudo-ops (see pseudo-op list) 

phase error B-2 

pound sign 3-8*, 5-2 



pseudo-op 






file terminating 6-29 




conditional 6-28 




interprogram communication 


6-17 


line 


2-3 




location counter 6-14 




radix 


6-2 




symbol table 6-3 




text 


6-24 




title 


6-1 




pseudo-op list of 




.BLK 


6-14 




.COMM 


6-17 




• CSIZ 


6-18 




.DALC 


6-7 




• DIAC 


6-12 




.DIO 


6-10 




.DIOA 


6-11 




.DMR 


6-8 




.DMRA 


6-9 




.DUSR 


6-13 




.END 


6-29 




.ENDC 


6-28 




.ENT 


6-19 




.ENTO 


6-19 




.EOT 


6-29 




.EXTD 


6-20 




.EXTN 


6-21 




.EXTU 


6-22 




.GADD 


6-22 




.GLOC 


6-23 




.IFE 


6-28 




• IFG 


6-28 
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.IFL 


6-28 


.IFN 


6-28 


.LOC 


6-15 


.NREL 


6-15 


.RDX 


6-2 


.TITL 


6-1 


.TXT 


6-24 


.TXTE 


6-24 


.TXTF 


6-24 


• TXTM 


6-26 


.TXTN 


6-25 


.TXTO 


6-24 


.XPNG 


6-13 


,ZREL 


6-15 



Q error code B-2 
questionable line error B-2 
quotation mark 1-4, 3-7, 3-8 



error code B-2 

shift field of ALC 5-2, 5-3 

radix 

50 format for symbols App. F 
changing input (.RDX) 6-2*, 3-2 
changing to base 10 6-2, 3-2*, 3-3 
pseudo-op 6-2 
range 6-2 

RDOS operating procedures D-2 

•RDX 6-2*, 3-2 

READS 5-13 

relative address 

in MR 5-4ff 

relocated by loader 1-1 

relocatable data block E-4 

relocation 

constant 4-3 

definition 1-1, 4-3ff 

error B-2 

flags 1-4 

property of expression 4-3ff 

rubout character 2-1 



semi-permanent symbol 

ALC instructions 6-7 

defining a new 3-7, 6-13 

definition of 3-6 

incorporating in assembler 3-7,6-13 

instructions without field 

specifications 6-13 
I/O instructions 6-lOff 
list of App. C 
MR instructions 6-8ff 
removing 6-13 

SEZ 5-3 

shift field of ALC 5-2, 5-3 

sign of number 3-2 

single precision integer 3-2 

skip field of ALC 5-2, 5-3 

SKP 5-3 

SKPBN 5-9 

SKPBZ 5-9 

SKPDN 5-9 

SKPDZ 5-9 

SNC 5-3 

SNR 5-3 

source program Chapt. 2 
definition 1-2 
lines of 1-2, 2-2ff 
scan 1-3 

space (A) i , 3-1 

special atom 

@ 3-8 

# 3-8 

3-8 

STA 5-8 

start block E-6 

storage word 

definition 2-2 

double 3-3, 3-4 

generated by characters 6-24 

value of .EXTN 6-21 



carry field of ALC 5-2, 5-3 
error code B-2 
global switch D-2 
local switch D-2, D-6 
pulse field of I/O 5-10 



SBN 5-3 



semicolon 3-1, 2-4 



string 

packing 6-26 
termination 6-24, 6-25 
text pseudo-ops 6-24ff 

SUB 5-2 

subtraction 3-1, 4-1 
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switch 



global D-2, D-6 
local D-2, D-6 



symbol 



class of atom 3-1 

definition 3-5 

global 3-7 

local 3-7 

multiply defined error B-1 

permanent 3-6, Chapt. 6 

removing 6-13 

representation in Radix 50 App. F 

semi— permanent 3—6 

table 

cross reference listing 1-4 

pseudo-ops 6-3 ff 
types of 3-5ff 
unv^ej-xnBu error B— 1 
user 3-7 

SZC 5-3 

SZR 5-3 

T 

error code B-2 

global switch D-2 , D-6 

tabulation 3-1, 2-5 

terminal atom 3-1 

text 

error B-2 
pseudo-ops 6-24 
string 6-24 

.TITL 6-1 

title 

block E-7 
pseudo-op 6-1 

.TXT 6-24 

.TXTE 6-24 

.TXTF 6-2 4 

.TXTM 6-26 

.TXTN 6-25 

.TXTO 6-24 



U 



error code B-2 

global switch D-2, D-6 



undefined symbol 

error code B-2 
pseudo-op (.EXTU) 6-22 

unlabeled COMMON block E-9 



value 



relocation 4-3ff 
storage word 2-2 



error code B-2 
global switch D-2 



.XPNG 6-13 



carry field of ALC 5-2 
error code B-2*, 4-1 



, ZREL 6-15 
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